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

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

> XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

以非同步方式取得要用於多人遊戲流量的慣用本機 UDP 連接埠。

## 語法

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

### 參數

*asyncBlock*   \_Inout\_\
類型：[XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock)\*

傳遞給 [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun) 之 [XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock) 的指標。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

在後續的[通訊端繫結](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind)作業中使用傳回的慣用本機 UDP 多人遊戲連接埠。此連接埠專門針對多人即時遊戲網路流程，僅對 UDP 流量有意義，對 TCP 或 HTTP 流量則無意義。

若要接聽慣用本機 UDP 多人遊戲連接埠的變更，請呼叫 [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged)。

如需本機 UDP 多人遊戲連接埠運作方式的說明，請參閱同步版本 [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport) 的「備註」一節。

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [慣用 UDP 多人遊戲連接埠](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## 另請參閱

[慣用本機 UDP 多人遊戲連接埠](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2)\
[Microsoft Azure PlayFab Party](/zh-TW/build/console-features/networking/game-mesh/playfab-party-intro-networking)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasyncresult.md)
- [Preferred local UDP multiplayer port networking APIs](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [API de redes del puerto multijugador UDP local preferido](/es/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [首选本地 UDP 多人游戏端口网络 API](/zh-CN/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)