> ## 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-CN/reference/system/xpackage/functions/xpackagegetwritestats.md) 函数使用 `XpackageWriteStats` 结构来指定和接收当前间隔的写入统计信息 (writeStats)。

> [!NOTE]
>
> 游戏跟踪的第一个间隔不会更新 *elapsed*，并且在超过 *budget* 时不会导致记录超限事件。一旦总 *budget* 的数据首次被写入完毕，间隔将重置，*elapsed* 值将开始更新。之后游戏中的后续间隔将根据间隔时间进行重置，并在超过 *budget* 时触发超限事件。

有关 XBOX One 主机游戏所使用打包技术的信息，请参阅[打包概述](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging.md)。有关创建 XVC 包步骤的信息，请参阅[开始为 XBOX 主机打包游戏](https://docs.xbox.com/zh-CN/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-CN/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)\
[XPackage](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)


## Related topics

- [XPackageGetWriteStats](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetwritestats.md)
- [XPackage（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)
- [Xbox 主机上的本地存储](https://docs.xbox.com/zh-CN/build/console-features/storage/local-storage.md)
- [EnableWritesToPackageRoot 元素 (MicrosoftGame.config)。](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-enablewritestopackageroot.md)
- [XblTitleManagedStatsWriteAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/title_managed_statistics_c/functions/xbltitlemanagedstatswriteasync.md)