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

# XNetworkingQueryPreferredLocalUdpMultiplayerPort

> XNetworkingQueryPreferredLocalUdpMultiplayerPort

# XNetworkingQueryPreferredLocalUdpMultiplayerPort

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

## Sintaxe

```cpp theme={null}
HRESULT XNetworkingQueryPreferredLocalUdpMultiplayerPort(
         uint16_t* preferredLocalUdpMultiplayerPort
)
```

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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

A porta multijogador UDP local preferencial retornada é a porta local a ser usada em uma operação subsequente de [associação de soquete](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind), 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)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2). 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`.

<Note>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](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-htons) para converter o endianness da porta retornada ao passá-la para a função bind.</Note>

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](/pt-BR/build/console-features/networking/game-mesh/playfab-party-intro-networking) 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

* [Porta multijogador UDP preferencial](/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)
* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[APIs de rede da porta multijogador UDP local preferencial](/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2)\
[Microsoft Azure PlayFab Party](/pt-BR/build/console-features/networking/game-mesh/playfab-party-intro-networking)\
[XNetworking](/pt-BR/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)