> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md) 函式的選擇性內容指標。

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

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

### 傳回值

類型：void

## 備註

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

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

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)\
[XNetworking](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworking (API 內容)](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)