> ## 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](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged) 函数的可选上下文指针。

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

指向按主机顺序的首选本地用户数据报协议 (UDP) 多人游戏端口的指针。

### 返回值

类型：void

## 备注

当游戏侦听首选本地 UDP 多人游戏端口的更改时，将调用 `XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback`。会尽一切努力确保在游戏运行时首选本地 UDP 多人游戏端口不会更改。但是，在某些不可避免的情况下，由于用户的外部网络条件变化并使任何现有套接字流失效，端口会发生变化。特别是当[网络连接级别](/build/console-features/networking/initialization-connectivity-networking)发生变化时，或作为游戏挂起/恢复循环的一部分时，端口尤其可能发生变化。

有关详细信息，请参阅[首选本地用户数据报协议 (UDP) 多人游戏端口网络 API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking) 中的“首选本地 UDP 多人游戏端口的更改”部分。

此方法查询调用进程内的本地状态并快速返回，因此可从时间敏感的上下文中安全调用。

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

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


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworking](/zh-CN/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)