XPackageGetWriteStats

获取输出写入统计信息 (writeStats)。

语法

HRESULT XPackageGetWriteStats(  
         XPackageWriteStats* writeStats  
)  

参数

writeStats _Out_
类型:XPackageWriteStats *

指向 XPackageWriteStats 结构的指针。

返回值

类型:HRESULT

HRESULT 成功或错误代码。 该函数仅在成功时填充 writeStats

备注

此函数调用系统以返回当前时间间隔的写入统计信息。 如果成功,它将使用输出写入统计信息填充 XPackageWriteStats 结构。

它检索游戏的当前写入统计信息,包括当前间隔长度、当前间隔中的已用时间、此间隔的总预算以及写入量。 这些统计信息可用于确保游戏不会在某个时间间隔内写入过多内容而触发可能阻止游戏通过认证的事件。

writeStats Description
Interval 这是一个 64 位值,指示当前写入间隔的总时间量(以毫秒为单位)。
预算 这是一个 64 位值,指示系统允许游戏在当前间隔内写入的数据量,而不会导致记录超出的事件。
写入的字节 这是一个 64 位值,指示游戏在当前间隔中写入的字节数。
Time Elapsed 这是一个 64 位值,指示当前间隔内的已用时间量(以毫秒为单位)。

注意

被游戏跟踪的首个间隔不会更新 elapsed,并且在超过 Budget 时不会导致超出的事件被记录。 写入一次数据的总 Budget 后,将重置间隔,并且 Time Elapsed 值将开始更新。 然后,游戏中的间隔将基于间隔时间重置,如果超过 Budget,则将触发超出的事件。

要求

头文件:XPackage.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

面向 Xbox 主机的包装游戏入门
打包概述
XPackage