XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
Inscrit une fonction de rappel à appeler lorsque le port multijoueur UDP local préféré change.Syntaxe
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* Fonction de rappel à appeler lorsque le port préféré change. token _Out_
Type : XTaskQueueRegistrationToken* Jeton utilisé pour identifier le rappel lors de l’appel de 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 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 SeriesDocumentation conceptuelle
Voir aussi
API réseau du port multijoueur UDP local préféréXNetworking