Skip to main content

XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged

取消註冊先前使用 XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged 註冊的回呼函式。

語法

參數

token   _In_
類型:XTaskQueueRegistrationToken
從 XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged 傳回的權杖。 wait   _In_
類型:bool
指出是否要封鎖直到所有擱置中的回呼完成為止。

傳回值

類型:bool 如果 wait 為 false 且取消註冊呼叫仍在擱置中,則傳回 false。否則傳回 true。

備註

只有在 wait 參數為 false 時,才能安全地在時間敏感執行緒上呼叫此函式。如需詳細資訊,請參閱時間敏感執行緒。
此函式會執行下列動作:
  • 與權杖相關聯的回呼會從已註冊的回呼集合中移除。
  • 如果該回呼權杖沒有正在執行的回呼,呼叫會傳回 true。
  • 如果有回呼正在執行且 wait 為 true,呼叫會封鎖直到正在執行的回呼完成為止。
  • 如果有回呼正在執行且 wait 為 false,呼叫不會封鎖,但會傳回 false。當該權杖的回呼完成時,權杖會自動取消註冊。
如果 wait 為 true,則不應從 XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback 內呼叫此函式,因為這會造成死結。
此機制可支援下列程式撰寫模式:
  • 您可以在取消註冊時封鎖,以確保在取消註冊呼叫之後永遠不會叫用您的回呼。
  • 您可以選擇不封鎖。如果需要確保在刪除資料之前回呼已完成,您可以定期呼叫此函式並將 wait 設定為 false。當它最終傳回 true 時,表示所有回呼都已完成,您可以刪除狀態。
  • 如果您的回呼不在意是否在取消註冊呼叫期間被叫用,您可以為 wait 傳遞 false 並忽略傳回值。

需求

標頭: XNetworking.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XNetworkingQueryPreferredLocalUdpMultiplayerPort
慣用本機 UDP 多人遊戲連接埠網路 API
XNetworking
Last modified on October 6, 2026