> ## 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.

# XPackageWriteStats

> XPackageWriteStats

# XPackageWriteStats

包含輸出寫入統計資料 (writeStats)。

## 語法

```cpp theme={null}
typedef struct XPackageWriteStats {  
    uint64_t interval;  
    uint64_t budget;  
    uint64_t elapsed;  
    uint64_t bytesWritten;  
} XPackageWriteStats  
```

### 成員

*interval*\
類型：uint64\_t

讀取/寫入：目前間隔的總時間長度 (以毫秒為單位)。

*budget*\
類型：uint64\_t

讀取：系統允許遊戲在目前間隔內寫入，而不會導致記錄超出事件的資料量。

*elapsed*\
類型：uint64\_t

讀取/寫入：目前間隔中已經過的時間 (以毫秒為單位)。

*bytesWritten*\
類型：uint64\_t

讀取/寫入：遊戲在目前間隔中寫入的位元組數目。

## 備註

[XPackageGetWriteStats](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetwritestats.md) 函式會使用 `XpackageWriteStats` 結構，來指定及接收目前間隔的寫入統計資料 (writeStats)。

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

如需 XBOX One 遊戲所使用之封裝技術的相關資訊，請參閱[封裝概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging.md)。如需建立 XVC 套件之步驟的相關資訊，請參閱[開始為 XBOX 主機封裝遊戲](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)。

## 需求

**標頭：** XPackage.h

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

## 另請參閱

[可下載內容 (DLC) 套件概觀](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)\
[XPackage](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)


## Related topics

- [XPackageGetWriteStats](https://docs.xbox.com/zh-TW/reference/system/xpackage/functions/xpackagegetwritestats.md)
- [XPackage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xpackage/xpackage_members.md)
- [Xbox 主機上的本機儲存空間](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)
- [EnableWritesToPackageRoot 元素 (MicrosoftGame.config)。](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-enablewritestopackageroot.md)
- [XblTitleManagedStatsWriteAsync](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/title_managed_statistics_c/functions/xbltitlemanagedstatswriteasync.md)