Skip to main content
処理中であったマッチメイキング状態変更の配列を返します。

構文

パラメーター

handle   PFMultiplayerHandle PFMultiplayer API インスタンスのハンドルです。 stateChangeCount   uint32_t stateChanges で指定されたリストに含まれ、PFMultiplayerStartProcessingMatchmakingStateChanges() から以前に返され、タイトルによって処理された変更の数です。 stateChanges   PFMatchmakingStateChange* const*
サイズ stateChangeCount の入力配列
PFMultiplayerStartProcessingMatchmakingStateChanges() から以前に返され、タイトルによって処理された変更の配列です。

戻り値

型: HRESULT 呼び出しが成功した場合は S_OK、それ以外の場合はエラー コード。エラー コードを人間が読める形式で取得するには、PFMultiplayerGetErrorMessage() を使用します。

解説

このメソッドは、以前の PFMultiplayerStartProcessingMatchmakingStateChanges() 呼び出しによって報告された状態変更がタイトルによって処理されたことを Matchmaking ライブラリに通知するため、それらに関連付けられたリソースを再利用できます。任意の数の状態変更を指定して PFMultiplayerFinishProcessingMatchmakingStateChanges() を呼び出すことができます。PFMultiplayerStartProcessingMatchmakingStateChanges() から返された各状態変更は、PFMultiplayerFinishProcessingMatchmakingStateChanges() へちょうど 1 回だけ返す必要がありますが、順序に関係なく返すことができ、他の PFMultiplayerStartProcessingMatchmakingStateChanges() 呼び出しからの状態変更とインターリーブしても構いません。

特定の状態変更に関連付けられているすべてのリソースは、その状態変更が PFMultiplayerFinishProcessingMatchmakingStateChanges() へ返されるまで有効であることが保証されます。

最良の結果を得るためには、PFMultiplayerFinishProcessingMatchmakingStateChanges() を呼び出すまでに状態変更の処理に費やす時間を最小限に抑えるようにしてください。

要件

ヘッダー: PFMatchmaking.h

関連項目

PFMatchmaking のメンバー
PFMatchmakingStateChange
PFMultiplayerStartProcessingMatchmakingStateChanges
最終更新日 2026年8月13日