XPackageGetWriteStats

出力書き込み統計 (writeStats) を取得します。

構文

HRESULT XPackageGetWriteStats(  
         XPackageWriteStats* writeStats  
)  

パラメーター

writeStats _Out_
型: XPackageWriteStats*

XPackageWriteStats 構造体へのポインター。

戻り値

型: HRESULT

HRESULT 成功またはエラー コード。 この関数は、成功した場合にのみ writeStats に値を設定します。

解説

この関数は、システムを呼び出して、現在の期間の書き込みの統計情報を返します。 成功した場合は、出力書き込み統計が XPackageWriteStats 構造体に設定されます。

これは、現在の間隔の長さ、現在の期間で経過した時間、この期間の合計予算、および書き込まれた量など、タイトルに対する現在の書き込みの統計情報を取得します。 ゲームの認定合格を妨げる可能性があるイベントが発生しないよう、これらの統計情報を使用して、ゲームで期間内に多くのコンテンツを書き込みすぎないようにすることができます。

writeStats 説明
Interval 現在の書き込み期間の合計時間 (ミリ秒) を示す 64 ビット値です。
Budget 超過したイベントがログに記録されることなく、システムがタイトルに対して現在の期間への書き込みを許可するデータ量を示す 64 ビット値です。
Bytes Written 現在の期間にタイトルによって書き込まれたバイト数を示す 64 ビット値です。
Time Elapsed 現在の期間の合計経過時間 (ミリ秒) を示す 64 ビット値です。

注意

タイトルによって追跡される最初の間隔は経過時間を更新せず、予算を超えたときに超過イベントがログに記録されることはありません。 データの合計予算が 1 回書き込まれると、間隔がリセットされ、経過時間の値の更新が開始されます。 タイトルの将来の間隔は、間隔の時間に基づいてリセットされ、予算を超過した場合は超過イベントがトリガーされます。

要件

ヘッダー: XPackage.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

Xbox 本体用タイトルのパッケージ化を開始する
パッケージ化の概要
XPackage