Pular para o conteúdo principal

​
XNetworkingQueryPreferredLocalUdpMultiplayerPort

Obtém a porta UDP local preferencial a ser usada para o tráfego multijogador.

​
Sintaxe

​
Parâmetros

preferredLocalUdpMultiplayerPort   _Out_
Tipo: uint16_t* Ponteiro para o número da porta UDP (User Datagram Protocol) (no formato endian do host) que é a porta multijogador UDP local preferencial.

​
Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

​
Comentários

Não é seguro chamar essa função em um thread sensível ao tempo. Para obter mais informações, confira Threads sensíveis ao tempo.
A porta multijogador UDP local preferencial retornada é a porta local a ser usada 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. Use a função htons para converter o endianness da porta retornada ao passá-la para a função bind.
Não há garantia de que a porta retornada possa ser usada para estabelecer uma conexão de soquete bem-sucedida com o servidor ou os pares desejados. Toda a lógica normal de repetição e fallback do título deve ser executada. Espera-se que o título forneça uma camada de segurança e quaisquer implementações necessárias de detecção e travessia de NAT (Network Address Translation) que possa exigir. É altamente recomendável que os títulos usem essa porta para o fluxo de soquete do tráfego principal do jogo, para ter a melhor chance de obter uma conexão bem-sucedida. A biblioteca do Microsoft Azure PlayFab Party usa essa porta por padrão. A menos que você configure explicitamente a biblioteca do PlayFab Party para usar uma porta diferente, não se associe diretamente à porta multijogador UDP local preferencial.

​
Requisitos

Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

​
Documentação conceitual

​
Confira também

APIs de rede da porta multijogador UDP local preferencial
Windows Sockets (Winsock)
Microsoft Azure PlayFab Party
XNetworking
Última modificação em 19 de outubro de 2026