> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

> XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

註冊在慣用本機 UDP 多人遊戲連接埠變更時要呼叫的回呼函式。

## 語法

```cpp theme={null}
HRESULT XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### 參數

*queue*   \_In\_opt\_\
類型：XTaskQueueHandle

要在其中註冊回呼的佇列。佇列的工作端和完成端都會使用。

*context*   \_In\_opt\_\
類型：void\*

要傳遞給回呼的選擇性內容指標。

*callback*   \_In\_\
類型：[XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/zh-TW/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback)\*

慣用連接埠變更時要呼叫的回呼函式。

*token*   \_Out\_\
類型：[XTaskQueueRegistrationToken](/zh-TW/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

呼叫 [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/zh-TW/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged) 時用來識別回呼的權杖。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

註冊慣用本機使用者資料包通訊協定 (UDP) 多人遊戲連接埠變更通知時，一律會引發初始通知回呼。

系統會盡一切努力確保慣用的本機 UDP 多人遊戲連接埠在遊戲執行期間不會變更。不過，在某些無法避免的情況下，由於使用者的外部網路狀況變更並使任何現有的通訊端流程失效，連接埠將會變更。特別是當[網路連線層級](/zh-TW/build/console-features/networking/initialization-connectivity-networking)變更時，或在遊戲的暫停/繼續週期中，連接埠更可能會變更。

當慣用本機 UDP 多人遊戲連接埠變更時，來自未來對等節點的其他輸入連線可能會在任何先前的慣用連接埠上遭到封鎖。這可能不會在通訊端層造成失敗，但遊戲最終可能會停止在繫結至任何先前慣用連接埠的通訊端上接收封包。

與現有對等節點之間傳送和接收的封包可能會繼續運作，因此慣用本機 UDP 多人遊戲連接埠變更通知對任何進行中的遊戲工作階段而言可能並非致命。

發生變更通知時，遊戲應盡早移轉至繫結在新慣用連接埠上的新通訊端，且不中斷任何現有的遊戲過程。如果遊戲偵測到連線中斷並重試通訊端連線，遊戲應一律使用最新的慣用連接埠。

此方法會查詢呼叫處理程序內的本機狀態並快速傳回，因此可以安全地從時間敏感的內容中呼叫。

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [慣用 UDP 多人遊戲連接埠](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## 另請參閱

[慣用本機 UDP 多人遊戲連接埠網路 API](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback.md)