> ## 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-CN/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-CN/build/console-features/storage/local-storage.md)

## 另请参阅

[开始为 XBOX 主机打包游戏](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)\
[打包概述](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging.md)\
[XPackage](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)


## Related topics

- [XPackageWriteStats](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagewritestats.md)
- [Xbox 主机上的本地存储](https://docs.xbox.com/zh-CN/build/console-features/storage/local-storage.md)
- [XPackage（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)
- [在 Unity 项目中使用 GDK API 的 C# 包装器](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md)