> ## 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)。

## 語法

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

### 參數

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

`XPackageWriteStats` 結構的指標。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。只有在函式成功時，才會填入 *writeStats*。

## 備註

此函式會呼叫系統，以傳回目前間隔時間內的寫入統計資料。如果成功，它會將輸出寫入統計資料填入 `XPackageWriteStats` 結構。

它會擷取遊戲的目前寫入統計資料，包括目前間隔長度、目前間隔中已經過的時間、此間隔的總預算，以及已寫入的數量。這些統計資料可用來確保遊戲不會在一個間隔內寫入過多內容，進而觸發可能導致遊戲無法通過認證的事件。

| **writeStats** | **描述** |
| - | - |
| **Interval** | 這是 64 位元值，表示目前寫入間隔的總時間量 (以毫秒為單位)。 |
| **Budget** | 這是 64 位元值，表示系統允許遊戲在目前間隔中寫入、而不會導致記錄超出事件的資料量。 |
| **Bytes Written** | 這是 64 位元值，表示遊戲在目前間隔中已寫入的位元組數。 |
| **Time Elapsed** | 這是 64 位元值，表示目前間隔中已經過的時間量 (以毫秒為單位)。 |

> [!NOTE]
>
> 遊戲追蹤的第一個間隔不會更新 *Time Elapsed*，且超過 *Budget* 時不會導致記錄超出事件。一旦寫入的資料總量達到 *Budget* 一次後，間隔就會重設，*Time Elapsed* 值也會開始更新。之後遊戲中的間隔會根據間隔時間重設，並在超過 *Budget* 時觸發超出事件。

## 需求

**標頭：** XPackage.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [XBOX 主機上的本機儲存體](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)

## 另請參閱

[開始為 XBOX 主機封裝遊戲](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)\
[封裝概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging.md)\
[XPackage](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)


## Related topics

- [XPackageWriteStats](https://docs.xbox.com/zh-TW/reference/system/xpackage/structs/xpackagewritestats.md)
- [Xbox 主機上的本機儲存空間](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)
- [XPackage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md)