Pular para o conteúdo principal
Descobre beacons de QoS por meio de PFMultiplayerServerListQosServersForTitleAsync e executa ping em cada um deles por UDP/3075. Agrega as latências e retorna a lista ordenada. A duração em tempo real é limitada a aproximadamente ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion mais o custo da chamada ListQosServersForTitle.

Sintaxe

Parâmetros

entityHandle PFEntityHandle Entidade do PlayFab autenticada. O mesmo identificador aceito por PFMultiplayerServerListQosServersForTitleAsync. options PFMultiplayerServerPingQosServersOptions*
optional
Opcional. NULL significa aplicar os padrões documentados em PFMultiplayerServerPingQosServersOptions. async XAsyncBlock*
Inout
XAsyncBlock para a operação assíncrona. Respeita XAsyncCancel.

Valor de retorno

Tipo: HRESULT Código de resultado desta operação de API.

Comentários

Esta API está disponível em todas as plataformas. Uma rede em que todas as regiões atingem o tempo limite (por exemplo, um firewall corporativo que bloqueia UDP/3075) não é um modo de falha: a operação é concluída com S_OK e cada PFMultiplayerServerQosResult é marcado como inacessível para que os chamadores possam detectar e exibir essa condição. Quando a operação assíncrona for concluída, chame PFMultiplayerServerPingQosServersGetResultSize e PFMultiplayerServerPingQosServersGetResult para obter o resultado.

Requisitos

Cabeçalho: PFMultiplayerServerQoS.h

Confira também

Membros de PFMultiplayerServerQoS
Última modificação em 16 de outubro de 2026