Skip to main content

XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

在慣用的本機多人遊戲連接埠變更時呼叫。

語法

參數

context   _In_opt_
類型:void*
傳遞給 XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged 函式的選擇性內容指標。 preferredLocalUdpMultiplayerPort   _In_
類型:uint16_t
以主機位元組順序表示之慣用本機使用者資料包通訊協定 (UDP) 多人遊戲連接埠的指標。

傳回值

類型:void

備註

當遊戲接聽慣用本機 UDP 多人遊戲連接埠的變更時,就會呼叫 XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback。系統會盡一切努力確保慣用的本機 UDP 多人遊戲連接埠在遊戲執行期間不會變更。不過,在某些無法避免的情況下,由於使用者的外部網路狀況變更並使任何現有的通訊端流程失效,連接埠將會變更。當網路連線層級變更時,或在遊戲的暫停/繼續週期中,連接埠特別可能會變更。 如需詳細資訊,請參閱慣用本機使用者資料包通訊協定 (UDP) 多人遊戲連接埠網路 API 的「慣用本機 UDP 多人遊戲連接埠的變更」一節。 此方法會查詢呼叫處理程序內的本機狀態並快速傳回,因此可以安全地從時間敏感的內容中呼叫。

需求

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

另請參閱

XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
XNetworking
Last modified on October 6, 2026