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
最后修改于 2026年8月24日