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

Obtient le port UDP local préféré à utiliser pour le trafic multijoueur.

## Syntaxe

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

### Paramètres

*preferredLocalUdpMultiplayerPort*   \_Out\_\
Type : uint16\_t\*

Pointeur vers le numéro de port UDP (User Datagram Protocol), au format boutiste de l'hôte, qui correspond au port multijoueur UDP local préféré.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread où le temps est critique. Pour plus d'informations, consultez [Threads où le temps est critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Le port multijoueur UDP local préféré retourné est le port local à utiliser dans une opération [bind de socket](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind) subséquente, par opposition au port public que les appareils distants pourraient utiliser pour se connecter à l'appareil local. Il n'est pertinent que pour le trafic UDP, et non pour le trafic TCP ou HTTP, car il cible précisément les flux réseau en temps réel des titres multijoueurs.

Ce port est par défaut le port UDP 3074, mais il existe à la fois des solutions de repli automatiques lorsque le port est jugé inadéquat pour le trafic de jeu, et un remplacement manuel que les utilisateurs peuvent définir au moyen de l'utilitaire de résolution des problèmes des paramètres réseau XBOX. Le comportement réseau de ce port sert à déterminer le type de NAT visible par l'utilisateur : strict, modéré ou ouvert. Le port est utilisé par la conversation de groupe XBOX, l'utilitaire de résolution des problèmes réseau XBOX, la documentation de dépannage en ligne de XBOX Live et les flux de dépannage du CSS, et il est souvent configuré manuellement par les utilisateurs dans leurs routeurs domestiques.

Le port retourné sera déjà configuré dans le routeur domestique de l'utilisateur au moyen d'UPnP afin d'autoriser les paquets entrants et sortants.

Le port doit être traité comme n'importe quel autre port et doit être utilisé conjointement avec les API [Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2). Le titre doit effectuer une liaison à la fois en IPv4 et en IPv6 sur ce port, ou utiliser un socket à double pile, et doit effectuer la liaison à l'adresse `INADDR_ANY`/`in6addr_any`.

<Note>Le port est retourné par cette fonction dans l'ordre boutiste de l'hôte. Les champs `sockaddr_in::sin_port` et `sockaddr_in6::sin6_port` sont tous deux dans l'ordre boutiste du réseau. Utilisez la fonction [htons](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-htons) pour convertir l'ordre des octets du port retourné lorsque vous le passez à la fonction bind.</Note>

Rien ne garantit que le port retourné pourra être utilisé pour établir une connexion de socket réussie avec le serveur ou les pairs souhaités. Toute la logique habituelle de nouvelle tentative et de repli du titre doit être appliquée.

Le titre doit fournir une couche de sécurité ainsi que toute implémentation de détection et de traversée de NAT (Network Address Translation) dont il pourrait avoir besoin.

Il est fortement recommandé aux titres d'utiliser ce port pour leur principal flux de socket de trafic de jeu afin de maximiser les chances d'obtenir une connexion réussie. La bibliothèque [Microsoft Azure PlayFab Party](/fr-CA/build/console-features/networking/game-mesh/playfab-party-intro-networking) utilise ce port par défaut. À moins de configurer explicitement la bibliothèque PlayFab Party pour qu'elle utilise un autre port, n'effectuez pas de liaison directe au port multijoueur UDP local préféré.

## Configuration requise

**En-tête :** XNetworking.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Port multijoueur UDP préféré](/fr-CA/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)
* [Threads où le temps est critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[API réseau du port multijoueur UDP local préféré](/fr-CA/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](/fr-CA/build/console-features/networking/game-mesh/playfab-party-intro-networking)\
[XNetworking](/fr-CA/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [Preferred local UDP multiplayer port networking APIs](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [API de redes del puerto multijugador UDP local preferido](/es/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)