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

# XPackageGetWriteStats

> XPackageGetWriteStats

# XPackageGetWriteStats

取得輸出寫入統計資料 (writeStats)。

<a id="syntaxSection" />

## 語法

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

<a id="parametersSection" />

### 參數

*writeStats*   \_Out\_\
類型：[XPackageWriteStats\*](/zh-TW/reference/system/xpackage/structs/xpackagewritestats)

`XPackageWriteStats` 結構的指標。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

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

<a id="remarksSection" />

## 備註

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

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

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

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

<a id="requirementsSection" />

## 需求

**標頭：** XPackage.h

**程式庫：** xgameruntime.lib

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

<a id="seealsoSection" />

## 概念文件

* [XBOX 主機上的本機儲存體](/zh-TW/build/console-features/storage/local-storage)

## 另請參閱

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


## Related topics

- [XPackageGetWriteStats](/reference/system/xpackage/functions/xpackagegetwritestats.md)
- [XPackageWriteStats](/reference/system/xpackage/structs/xpackagewritestats.md)