> ## 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.

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

> XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

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

## 語法

```cpp theme={null}
void XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback(
         void* context,
         uint16_t preferredLocalUdpMultiplayerPort
)
```

### 參數

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

傳遞給 [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged) 函式的選擇性內容指標。

*preferredLocalUdpMultiplayerPort*   \_In\_\
類型：uint16\_t

以主機位元組順序表示之慣用本機使用者資料包通訊協定 (UDP) 多人遊戲連接埠的指標。

### 傳回值

類型：void

## 備註

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

如需詳細資訊，請參閱[慣用本機使用者資料包通訊協定 (UDP) 多人遊戲連接埠網路 API](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking) 的「慣用本機 UDP 多人遊戲連接埠的變更」一節。

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

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