Skip to main content
检索自上次此类调用以来要处理的所有匹配状态变更数组。

语法

参数

handle   PFMultiplayerHandle PFMultiplayer API 实例的句柄。 stateChangeCount   uint32_t*
output
输出 stateChanges 数组中供 title 处理的 PFMatchmakingStateChange 条目数量。 stateChanges   PFMatchmakingStateChange* const**
大小为 *stateChangeCount 的库分配输出数组
一个库分配的输出数组,包含所有 PFMatchmakingStateChange 条目,供 title 处理,然后传递给 PFMultiplayerFinishProcessingMatchmakingStateChanges()

返回值

类型:HRESULT 如果调用成功,则为 S_OK;否则为错误代码。可以通过 PFMultiplayerGetErrorMessage() 获取错误代码的人类可读形式。

备注

此方法为匹配库提供与远程设备或服务同步状态的机会,并检索自上次调用此方法以来当前可供 title 使用的所有变更列表。title 应使用所提供的 0 或多个变更的数组来更新其自身状态或 UI,然后及时使用它们调用 PFMultiplayerFinishProcessingMatchmakingStateChanges()

库公开的匹配库状态可能会在此调用期间发生变化,因此使用时必须保证线程安全。应频繁调用 PFMultiplayerStartProcessingMatchmakingStateChanges() — 至少每图形帧调用一次。它的设计目标是快速执行并返回,因此可以在主 UI 线程上调用而不会造成明显影响。为获得最佳效果,还应尽量减少在调用 PFMultiplayerFinishProcessingMatchmakingStateChanges() 之前处理状态变更所花费的时间。

PFMultiplayerStartProcessingMatchmakingStateChanges() 返回的每个状态变更必须恰好一次返回给 PFMultiplayerFinishProcessingMatchmakingStateChanges(),但可以乱序返回,也可以与来自其他 PFMultiplayerStartProcessingMatchmakingStateChanges() 调用的状态变更交错返回。与特定状态变更关联的任何资源都保证在该状态变更返回给 PFMultiplayerFinishProcessingMatchmakingStateChanges() 之前一直有效。

要求

头文件: PFMatchmaking.h

另请参阅

PFMatchmaking 成员
PFMatchmakingStateChange
PFMultiplayerFinishProcessingMatchmakingStateChanges
最后修改于 2026年8月13日