Skip to main content

​
XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged

Annule l’inscription d’une fonction de rappel qui a été inscrite avec XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged.

​
Syntaxe

​
Paramètres

token   _In_
Type : XTaskQueueRegistrationToken Le jeton retourné par XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged. wait   _In_
Type : bool Indique s’il faut bloquer jusqu’à ce que tous les rappels en attente soient terminés.

​
Valeur de retour

Type : bool Retourne false si wait est false et que l’appel d’annulation d’inscription est en attente. Retourne true dans les autres cas.

​
Remarques

Cette fonction peut être appelée en toute sécurité sur un thread à délai critique uniquement si le paramètre wait est false. Pour plus d’informations, consultez Threads à délai critique.
Cette fonction effectue les actions suivantes :
  • Le rappel associé au jeton est retiré de l’ensemble des rappels inscrits.
  • Si aucun rappel n’est en cours d’exécution pour ce jeton de rappel, l’appel retourne true.
  • Si des rappels sont en cours d’exécution et que wait est true, l’appel bloque jusqu’à ce que le rappel en cours d’exécution soit terminé.
  • Si des rappels sont en cours d’exécution et que wait est false, l’appel ne bloque pas, mais retourne false. Lorsque le rappel pour le jeton est terminé, l’inscription du jeton est automatiquement annulée.
Cette fonction ne doit pas être appelée à partir d’un XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback si wait est true, car cela provoquerait un interblocage.
Ce mécanisme permet les modèles de codage suivants :
  • Vous pouvez bloquer lors de l’annulation de l’inscription pour garantir que vos rappels ne sont jamais invoqués après un appel d’annulation d’inscription.
  • Vous pouvez choisir de ne pas bloquer. Si vous devez vous assurer que vos rappels sont terminés avant de supprimer des données, vous pouvez appeler périodiquement cette fonction avec wait réglé à false. Lorsqu’elle retourne finalement true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  • Si votre rappel ne se soucie pas d’être invoqué pendant un appel d’annulation d’inscription, vous pouvez passer false pour wait et ignorer la valeur de retour.

​
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

​
Voir aussi

XNetworkingQueryPreferredLocalUdpMultiplayerPort
API réseau du port multijoueur UDP local préféré
XNetworking
Last modified on October 6, 2026