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 Jeton renvoyé par XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged. wait   _In_
Type : bool Indique s’il faut bloquer jusqu’à ce que tous les rappels en attente soient terminés.

​
Valeur renvoyée

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

​
Remarques

Cette fonction peut être appelée sans risque sur un thread à durée critique uniquement si le paramètre wait a la valeur false. Pour plus d’informations, consultez Threads à durée critique.
Cette fonction effectue les actions suivantes :
  • Le rappel associé au jeton est supprimé de l’ensemble des rappels inscrits.
  • Si aucun rappel n’est en cours d’exécution pour ce jeton de rappel, l’appel renvoie true.
  • Si des rappels sont en cours d’exécution et que wait a la valeur 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 a la valeur false, l’appel ne bloque pas mais renvoie false. Lorsque le rappel associé au jeton est terminé, l’inscription du jeton est automatiquement annulée.
Cette fonction ne doit pas être appelée depuis un XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback si wait a la valeur 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 appelé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 régulièrement cette fonction avec wait défini sur false. Lorsqu’elle renvoie enfin true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  • Si votre rappel ne se soucie pas d’être appelé pendant un appel d’annulation d’inscription, vous pouvez passer false pour wait et ignorer la valeur renvoyée.

​
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