语法
参数
stateChangeCount uint32_t*输出 用于写入标题在
stateChanges 数组中要处理的 PartyXblStateChange 条目数量的位置。
stateChanges PartyXblStateChangeArray*大小为
*stateChangeCount 的库分配的输出数组
用于存储指向所有 PartyXblStateChange 条目数组的指针的位置,标题应处理这些条目,然后传递给 FinishProcessingStateChanges()。
返回值
PartyError 若调用成功则返回c_partyErrorSuccess,否则返回错误代码。可通过 GetErrorMessage() 检索该错误代码的可读形式。
备注
此方法为 Party XBOX Live 帮助程序库提供一个机会,以检索自上次调用此方法以来标题当前可用的所有更改的列表。标题应使用所提供的 0 个或多个更改的数组更新其自身状态或 UI,然后及时调用 FinishProcessingStateChanges() 并传入这些更改。库公开的状态可能会在此调用期间发生变化,因此您必须在使用它时保证线程安全。应频繁调用 StartProcessingStateChanges() —— 至少每 100 毫秒一次。它设计为快速执行和返回,以便可以在主 UI 线程上调用而影响可忽略不计。为获得最佳结果,还应尽量减少在调用 FinishProcessingStateChanges() 之前处理状态更改所花费的时间。
由 StartProcessingStateChanges() 返回的每个状态更改必须准确地返回给 FinishProcessingStateChanges() 一次,但可以按不同顺序返回,并且可以与其他 StartProcessingStateChanges() 调用返回的状态更改交错。与特定状态更改关联的任何资源都保证在状态更改返回给 FinishProcessingStateChanges() 之前保持有效。
要求
头文件: PartyXboxLive.h另请参阅
PartyXblManagerPartyXblStateChange
PartyXblManager::FinishProcessingStateChanges