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

# XNetworkingQueryPreferredLocalUdpMultiplayerPort

> XNetworkingQueryPreferredLocalUdpMultiplayerPort

# XNetworkingQueryPreferredLocalUdpMultiplayerPort

取得要用於多人遊戲流量的慣用本機 UDP 連接埠。

## 語法

```cpp theme={null}
HRESULT XNetworkingQueryPreferredLocalUdpMultiplayerPort(
         uint16_t* preferredLocalUdpMultiplayerPort
)
```

### 參數

*preferredLocalUdpMultiplayerPort*   \_Out\_\
類型：uint16\_t\*

指向慣用本機 UDP 多人遊戲連接埠之使用者資料包通訊協定 (UDP) 連接埠號碼 (採主機位元組順序格式) 的指標。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

<Note>在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

傳回的慣用本機 UDP 多人遊戲連接埠是要在後續[通訊端繫結](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind)作業中使用的本機連接埠，而不是遠端裝置可能用來連線到本機裝置的公用連接埠。由於它專門針對多人即時遊戲網路流程，因此只對 UDP 流量有意義，而對 TCP 或 HTTP 流量則無意義。

此連接埠預設為 UDP 3074，但當判定連接埠不適合遊戲流量時，會有自動後援機制，使用者也可以透過 XBOX 網路設定疑難排解員手動覆寫。此連接埠的網路行為會用來決定使用者可見的 NAT 類型：嚴格、中等和開放。此連接埠由 XBOX 派對聊天、XBOX 網路疑難排解員、線上 XBOX Live 疑難排解文件以及 CSS 疑難排解流程使用，而且使用者經常會在家用路由器中手動設定此連接埠。

傳回的連接埠已透過 UPnP 在使用者的家用路由器中設定為允許輸入和輸出封包。

此連接埠應與其他所有連接埠一樣對待，並應搭配 [Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2) API 使用。遊戲應在此連接埠上同時繫結 IPv4 和 IPv6，或使用雙堆疊通訊端，並應繫結至 `INADDR_ANY`/`in6addr_any` 位址。

<Note>此函式傳回的連接埠採用主機位元組順序。`sockaddr_in::sin_port` 和 `sockaddr_in6::sin6_port` 欄位皆採用網路位元組順序。將傳回的連接埠傳遞給 bind 函式時，請使用 [htons](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-htons) 函式來轉換其位元組順序。</Note>

傳回的連接埠不保證能用來與所需的伺服器或對等節點成功建立通訊端連線。應執行任何一般的遊戲重試和後援邏輯。

遊戲應自行提供安全性層，以及其可能需要的任何網路位址轉譯 (NAT) 偵測和周遊實作。

強烈建議遊戲將此連接埠用於其主要遊戲流量通訊端流程，以獲得成功連線的最佳機會。[Microsoft Azure PlayFab Party](/zh-TW/build/console-features/networking/game-mesh/playfab-party-intro-networking) 程式庫預設會使用此連接埠。除非您明確將 PlayFab Party 程式庫設定為使用不同的連接埠，否則請勿直接繫結至慣用的本機 UDP 多人遊戲連接埠。

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [慣用 UDP 多人遊戲連接埠](/zh-TW/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)
* [時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[慣用本機 UDP 多人遊戲連接埠網路 API](/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

- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [Preferred local UDP multiplayer port networking APIs](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [API de redes del puerto multijugador UDP local preferido](/es/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)