Skip to main content
返回正在处理的匹配状态变更数组。

语法

参数

handle   PFMultiplayerHandle PFMultiplayer API 实例的句柄。 stateChangeCount   uint32_t stateChanges 指定的列表中提供的、先前由 PFMultiplayerStartProcessingMatchmakingStateChanges() 返回且现已被 title 处理的变更数量。 stateChanges   PFMatchmakingStateChange* const*
大小为 stateChangeCount 的输入数组
先前由 PFMultiplayerStartProcessingMatchmakingStateChanges() 返回且现已被 title 处理的变更数组。

返回值

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

备注

此方法通知匹配库:先前调用 PFMultiplayerStartProcessingMatchmakingStateChanges() 报告的状态变更现已被 title 处理,因此可以回收其关联资源。可以以任意数量的状态变更调用 PFMultiplayerFinishProcessingMatchmakingStateChanges()。PFMultiplayerStartProcessingMatchmakingStateChanges() 返回的每个状态变更必须恰好一次返回给 PFMultiplayerFinishProcessingMatchmakingStateChanges(),但可以乱序返回,也可以与来自其他 PFMultiplayerStartProcessingMatchmakingStateChanges() 调用的状态变更交错返回。

与特定状态变更关联的任何资源都保证在该状态变更返回给 PFMultiplayerFinishProcessingMatchmakingStateChanges() 之前一直有效。

为获得最佳效果,应尽量减少在调用 PFMultiplayerFinishProcessingMatchmakingStateChanges() 之前处理状态变更所花费的时间。

要求

头文件: PFMatchmaking.h

另请参阅

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