> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerStartProcessingMatchmakingStateChanges

> 前回の呼び出し以降に処理する PlayFab Multiplayer マッチメイキング状態変更の配列を取得し、タイトルがチケットやマッチの更新に応答できるようにします。

前回のそのような呼び出し以降に処理するすべてのマッチメイキング状態変更の配列を取得します。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerStartProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t* stateChangeCount,  
    const PFMatchmakingStateChange* const** stateChanges  
)  
```

### パラメーター

**`handle`**   PFMultiplayerHandle

PFMultiplayer API インスタンスのハンドルです。

**`stateChangeCount`**   uint32\_t\*\
*出力*

`stateChanges` 配列内でタイトルが処理する PFMatchmakingStateChange エントリの出力数です。

**`stateChanges`**   PFMatchmakingStateChange\* const\*\*\
*サイズ `*stateChangeCount` のライブラリ割り当て出力配列*

タイトルが処理し、その後 [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges) に渡すすべての PFMatchmakingStateChange エントリの、ライブラリ割り当て出力配列です。

### 戻り値

型: HRESULT

呼び出しが成功した場合は `S_OK`、それ以外の場合はエラー コード。エラー コードを人間が読める形式で取得するには、[PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) を使用します。

## 解説

このメソッドは、Matchmaking ライブラリにリモート デバイスまたはサービスとの状態同期の機会を提供し、このメソッドの前回の呼び出し以降にタイトルで現在利用可能なすべての変更のリストを取得します。タイトルは、提供された 0 個以上の変更の配列を使用して自身の状態や UI を更新し、それらを速やかに [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges) に渡す必要があります。<br /><br /> ライブラリによって公開される Matchmaking ライブラリの状態はこの呼び出し中に変更される可能性があるため、それを利用する際にはスレッド セーフである必要があります。PFMultiplayerStartProcessingMatchmakingStateChanges() は頻繁に (少なくともグラフィックスの 1 フレームにつき 1 回) 呼び出す必要があります。この関数は、メイン UI スレッドで呼び出しても影響がほぼ無視できるほど短時間で実行して戻るように設計されています。最良の結果を得るためには、PFMultiplayerFinishProcessingMatchmakingStateChanges() を呼び出すまでに状態変更の処理に費やす時間も最小限に抑えるようにしてください。<br /><br /> PFMultiplayerStartProcessingMatchmakingStateChanges() から返された各状態変更は、PFMultiplayerFinishProcessingMatchmakingStateChanges() へちょうど 1 回だけ返す必要がありますが、順序に関係なく返すことができ、他の PFMultiplayerStartProcessingMatchmakingStateChanges() 呼び出しからの状態変更とインターリーブしても構いません。特定の状態変更に関連付けられているすべてのリソースは、その状態変更が PFMultiplayerFinishProcessingMatchmakingStateChanges() へ返されるまで有効であることが保証されます。

## 要件

**ヘッダー:** PFMatchmaking.h

## 関連項目

[PFMatchmaking のメンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)\
[PFMatchmakingStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange)\
[PFMultiplayerFinishProcessingMatchmakingStateChanges](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)


## Related topics

- [PFMultiplayerFinishProcessingMatchmakingStateChanges](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges.md)
- [PFMatchmakingStateChange](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange.md)
- [非同期 Lobby and Matchmaking C++ SDK 操作ガイド](/ja-jp/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Matchmaking SDK quickstart](/ja-jp/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)