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

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

> XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

Inscrit une fonction de rappel à appeler lorsque le port multijoueur UDP local préféré change.

## Syntaxe

```cpp theme={null}
HRESULT XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### Paramètres

*queue*   \_In\_opt\_\
Type : XTaskQueueHandle

File d'attente dans laquelle inscrire le rappel. Les côtés travail et achèvement de la file d'attente sont tous deux utilisés.

*context*   \_In\_opt\_\
Type : void\*

Pointeur de contexte facultatif à passer au rappel.

*callback*   \_In\_\
Type : [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/fr/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback)\*

Fonction de rappel à appeler lorsque le port préféré change.

*token*   \_Out\_\
Type : [XTaskQueueRegistrationToken](/fr/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

Jeton utilisé pour identifier le rappel lors de l'appel de [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/fr/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged).

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

L'inscription à une notification de changement du port multijoueur UDP (User Datagram Protocol) local préféré déclenche toujours un rappel de notification initial.

Tout est mis en œuvre pour que le port multijoueur UDP local préféré ne change pas pendant l'exécution d'un titre. Toutefois, il existe des cas inévitables où le port change, en raison de la modification des conditions réseau externes de l'utilisateur, ce qui invalide tous les flux de sockets existants. En particulier, le port est beaucoup plus susceptible de changer lorsque le [niveau de connectivité réseau](/fr/build/console-features/networking/initialization-connectivity-networking) change, ou dans le cadre d'un cycle de suspension/reprise du titre.

Lorsque le port multijoueur UDP local préféré change, les connexions entrantes supplémentaires provenant de futurs pairs peuvent être bloquées sur tout port préféré précédent. Cela ne provoque pas forcément d'échec au niveau de la couche socket, mais le titre peut finir par ne plus recevoir de paquets sur un socket lié à un port préféré précédent.

Les paquets envoyés aux pairs existants et reçus de ceux-ci peuvent continuer à fonctionner ; une notification de changement du port multijoueur UDP local préféré n'est donc pas nécessairement fatale pour une session de jeu en cours.

Lorsqu'une notification de changement se produit, le titre doit migrer vers un nouveau socket lié au nouveau port préféré dès que possible, sans interrompre le jeu en cours. Si le titre détecte une perte de connexion et retente la connexion du socket, il doit toujours utiliser le port préféré le plus récent.

Cette méthode interroge l'état local au sein du processus appelant et retourne rapidement ; elle peut donc être appelée en toute sécurité depuis des contextes où le temps est critique.

## 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/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## Voir aussi

[API réseau du port multijoueur UDP local préféré](/fr/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/fr/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback.md)