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

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

> XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

异步获取用于多人游戏流量的首选本地 UDP 端口。

## 语法

```cpp theme={null}
HRESULT XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync(
         XAsyncBlock* asyncBlock
)
```

### 参数

*asyncBlock*   \_Inout\_\
类型：[XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)\*

指向传递给 [XAsyncRun](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncrun.md) 的 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md) 的指针。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

在后续[套接字绑定](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind)操作中使用返回的首选本地 UDP 多人游戏端口。此端口专门针对多人游戏实时游戏网络流，仅对 UDP 流量有意义，不适用于 TCP 或 HTTP 流量。

要侦听首选本地 UDP 多人游戏端口的更改，请调用 [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)。

有关本地 UDP 多人游戏端口如何工作的说明，请参阅 [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md) 同步版本的“备注”部分。

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

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

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

## 概念文档

* [首选 UDP 多人游戏端口](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)

## 另请参阅

[首选本地 UDP 多人游戏端口](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)\
[Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2)\
[Microsoft Azure PlayFab Party](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)\
[XNetworking](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasyncresult.md)
- [首选 UDP 多人游戏端口](https://docs.xbox.com/zh-CN/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworking（API 内容）](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/xnetworking_members.md)
- [在 Unity 项目中使用 GDK API 的 C# 包装器](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)