> ## 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.

# PFMultiplayerServerPingQosServersAsync

> PFMultiplayerServerListQosServersForTitleAsync を使用して QoS ビーコンを検出し、UDP/3075 経由で各ビーコンに ping を送信します。待機時間を集計し、並べ替えられた一覧を返します。実時間での所要時間の上限は、おおよそ ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion に ListQosServersForTitle 呼び出しのコストを加えた値です。

PFMultiplayerServerListQosServersForTitleAsync を使用して QoS ビーコンを検出し、UDP/3075 経由で各ビーコンに ping を送信します。待機時間を集計し、並べ替えられた一覧を返します。実時間での所要時間の上限は、おおよそ ceil(regionCount / maxConcurrentRegions) \* timeoutMs \* pingsPerRegion に ListQosServersForTitle 呼び出しのコストを加えた値です。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerServerPingQosServersAsync(  
    PFEntityHandle entityHandle,  
    const PFMultiplayerServerPingQosServersOptions* options,  
    XAsyncBlock* async  
)  
```

### パラメーター

**`entityHandle`**   PFEntityHandle

認証済みの PlayFab エンティティ。PFMultiplayerServerListQosServersForTitleAsync で受け入れられるものと同じハンドルです。

**`options`**   [PFMultiplayerServerPingQosServersOptions\*](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions)<br />*optional*

省略可能。NULL の場合は、PFMultiplayerServerPingQosServersOptions に記載されている既定値が適用されます。

**`async`**   XAsyncBlock\*<br />*Inout*

非同期操作用の XAsyncBlock。XAsyncCancel に対応しています。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API はすべてのプラットフォームで使用できます。すべてのリージョンがタイムアウトするネットワーク (たとえば、企業のファイアウォールが UDP/3075 をブロックしている場合) は、失敗モードではありません。操作は S\_OK で完了し、すべての PFMultiplayerServerQosResult が到達不能としてマークされるため、呼び出し元はその状態を検出して通知できます。非同期操作が完了したら、[PFMultiplayerServerPingQosServersGetResultSize](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) と [PFMultiplayerServerPingQosServersGetResult](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult) を呼び出して結果を取得します。

## 要件

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

## 関連項目

[PFMultiplayerServerQoS のメンバー](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members)


## Related topics

- [PFMultiplayerServerPingQosServersGetResult](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)
- [PFMultiplayerServerPingQosServersOptions](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersResult](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResultSize](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md)
- [Services C API overview - PFMultiplayerServerQoS.h](/ja-jp/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)