PFMultiplayerServerPingQosServersAsync

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

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

構文

HRESULT PFMultiplayerServerPingQosServersAsync(  
    PFEntityHandle entityHandle,  
    const PFMultiplayerServerPingQosServersOptions* options,  
    XAsyncBlock* async  
)  

パラメーター

entityHandle PFEntityHandle 認証済みの PlayFab エンティティ。PFMultiplayerServerListQosServersForTitleAsync で受け入れられるものと同じハンドルです。 options PFMultiplayerServerPingQosServersOptions*
optional 省略可能。NULL の場合は、PFMultiplayerServerPingQosServersOptions に記載されている既定値が適用されます。 async XAsyncBlock*
Inout 非同期操作用の XAsyncBlock。XAsyncCancel に対応しています。

戻り値

型: HRESULT この API 操作の結果コード。

解説

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

要件

ヘッダー: PFMultiplayerServerQoS.h

関連項目

PFMultiplayerServerQoS のメンバー

最終更新日 2026年10月16日

⌘I