PFMultiplayerFinishProcessingMatchmakingStateChanges

返回正在处理的匹配状态更改数组。

语法

HRESULT PFMultiplayerFinishProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t stateChangeCount,  
    const PFMatchmakingStateChange* const* stateChanges  
)  

参数

handle PFMultiplayerHandle

PFMultiplayer API 实例的句柄。

stateChangeCount uint32_t

stateChanges 指定的列表中提供的更改数,以前由 PFMultiplayerStartProcessingMatchmakingStateChanges() 返回,现在已由游戏处理。

stateChanges PFMatchmakingStateChange* const*
大小为 stateChangeCount 的输入数组

以前由 PFMultiplayerStartProcessingMatchmakingStateChanges() 返回的更改数组,这些更改现在已由游戏处理。

返回值

类型:HRESULT

如果调用成功,则为 S_OK,否则为错误代码。 可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。

备注

此方法通知 Matchmaking 库,之前调用 PFMultiplayerStartProcessingMatchmakingStateChanges() 报告的状态更改现已由游戏处理,因此可以回收其关联的资源。 可以使用任意数量的状态更改调用 PFMultiplayerFinishProcessingMatchmakingStateChanges()。 PFMultiplayerStartProcessingMatchmakingStateChanges() 返回的每个状态更改必须恰好返回给 PFMultiplayerFinishProcessingMatchmakingStateChanges() 一次,但可能会无序返回,并且可能与对 PFMultiplayerStartProcessingMatchmakingStateChanges() 的其他调用的状态更改交错。

与特定状态更改相关联的任何资源在状态更改返回到 PFMultiplayerFinishProcessingMatchmakingStateChanges() 之前都保证保持有效。

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

要求

标头: PFMatchmaking.h

另请参阅

PFMatchmaking 成员
PFMatchmakingStateChange
PFMultiplayerStartProcessingMatchmakingStateChanges