> ## 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-TW/reference/system/xasync/structs/xasyncblock.md)\*

傳遞給 [XAsyncRun](https://docs.xbox.com/zh-TW/reference/system/xasync/functions/xasyncrun.md) 之 [XAsyncBlock](https://docs.xbox.com/zh-TW/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-TW/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)。

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

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 概念文件

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

## 另請參閱

[慣用本機 UDP 多人遊戲連接埠](https://docs.xbox.com/zh-TW/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-TW/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)\
[XNetworking](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasyncresult.md)
- [慣用 UDP 多人遊戲連接埠](https://docs.xbox.com/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworking (API 內容)](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)