XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult
Obtém os resultados de uma chamada a XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync.Sintaxe
Parâmetros
asyncBlock _Inout_Tipo: XAsyncBlock* Ponteiro para a estrutura XAsyncBlock que foi passada para a função XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync. preferredLocalUdpMultiplayerPort _Out_
Tipo: uint16_t* Ponteiro para o número da porta UDP (User Datagram Protocol) local preferencial na ordem endian do host.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
Essa função obtém o número da porta UDP local preferencial para o tráfego multijogador assíncrono quando a estruturaXAsyncBlock é passada para a função NetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult. Para obter mais informações sobre a porta multijogador UDP local preferencial que está sendo recuperada, confira APIs de rede da porta multijogador UDP (User Datagram Protocol) local preferencial. Para obter informações de rede em títulos do Microsoft Game Development Kit (GDK), confira Recuperando informações de rede.
A porta multijogador UDP local preferencial retornada é a porta local utilizada em uma operação subsequente de associação de soquete, em oposição à porta pública que os dispositivos remotos podem usar para se conectar ao dispositivo local. Ela é significativa somente para o tráfego UDP, e não para o tráfego TCP ou HTTP, pois é voltada especificamente para os fluxos de rede de títulos multijogador em tempo real.
Essa porta usa como padrão a UDP 3074, mas há tanto fallbacks automáticos, quando se determina que a porta não é adequada para o tráfego de jogos, quanto uma substituição manual que os usuários podem definir por meio do solucionador de problemas das configurações de rede do XBOX. O comportamento de rede dessa porta é usado para determinar o tipo de NAT visível para o usuário: estrito, moderado e aberto. A porta é usada pelo XBOX Party Chat, pelo solucionador de problemas de rede do XBOX, pela documentação de solução de problemas online do XBOX Live e pelos fluxos de solução de problemas do CSS, e muitas vezes é configurada manualmente pelos usuários em roteadores domésticos.
A porta retornada já estará configurada no roteador doméstico do usuário por meio de UPnP para permitir pacotes de entrada e saída.
A porta deve ser tratada como qualquer outra porta e deve ser usada em conjunto com as APIs do Windows Sockets (Winsock). O título deve se associar ao IPv4 e ao IPv6 nessa porta ou usar um soquete de pilha dupla, e deve se associar ao endereço INADDR_ANY/in6addr_any.
A porta é retornada por essa função na ordem endian do host. Os campos
sockaddr_in::sin_port e sockaddr_in6::sin6_port estão ambos na ordem endian da rede. A função htons deve ser usada para converter o endianness da porta retornada ao passá-la para a função bind.Requisitos
Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncXNetworking