> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageGetWriteStats

> XPackageGetWriteStats

# XPackageGetWriteStats

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

## Syntax

```cpp theme={null}
HRESULT XPackageGetWriteStats(  
         XPackageWriteStats* writeStats  
)  
```

### Parameters

*writeStats*   \_Out\_\
型: [XPackageWriteStats\*](https://docs.xbox.com/ja-jp/reference/system/xpackage/structs/xpackagewritestats.md)

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

### Return value

型: HRESULT

HRESULT の成功またはエラー コード。関数が成功した場合にのみ *writeStats* が設定されます。

## Remarks

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

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

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

> [!NOTE]
>
> タイトルが追跡する最初の間隔では *Time Elapsed* は更新されず、*Budget* を超えても超過イベントがログに記録されません。データの合計 *Budget* が一度書き込まれると、間隔がリセットされ、*Time Elapsed* 値の更新が始まります。その後、タイトル内の将来の間隔は間隔時間に基づいてリセットされ、*Budget* を超えると超過イベントがトリガーされます。

## Requirements

**ヘッダー:** XPackage.h

**ライブラリ:** xgameruntime.lib

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

## Conceptual documentation

* [XBOX 本体のローカル ストレージ](https://docs.xbox.com/ja-jp/build/console-features/storage/local-storage.md)

## See also

[XBOX 本体用タイトルのパッケージング入門](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)\
[パッケージングの概要](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/overviews/packaging.md)\
[XPackage](https://docs.xbox.com/ja-jp/reference/system/xpackage/xpackage_members.md)


## Related topics

- [XPackageWriteStats](https://docs.xbox.com/ja-jp/reference/system/xpackage/structs/xpackagewritestats.md)
- [XPackage (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xpackage/xpackage_members.md)
- [Unity プロジェクトでの GDK API 用 C# ラッパーの使用](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/ja-jp/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md)
- [XPackageGetUserLocale](https://docs.xbox.com/ja-jp/reference/system/xpackage/functions/xpackagegetuserlocale.md)