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

[XAsyncRun](https://docs.xbox.com/ja-jp/reference/system/xasync/functions/xasyncrun.md) に渡される [XAsyncBlock](https://docs.xbox.com/ja-jp/reference/system/xasync/structs/xasyncblock.md) へのポインター。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

返される推奨されるローカル UDP マルチプレイヤー ポートを、後続の [socket bind](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind) 操作で使用してください。このポートはマルチプレイヤーのリアルタイム タイトル ネットワーク フローを特に対象としており、TCP や HTTP トラフィックではなく UDP トラフィックに対してのみ意味を持ちます。

推奨されるローカル UDP マルチプレイヤーの変更をリッスンするには、[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md) を呼び出します。

ローカル UDP マルチプレイヤー ポートの仕組みについては、同期バージョンの [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md) の「解説」セクションを参照してください。

このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間的制約のあるコンテキストから呼び出しても安全です。

## 要件

**ヘッダー:** XNetworking.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ コンソール、XBOX Series コンソール

## 概念ドキュメント

* [推奨される UDP マルチプレイヤー ポート](https://docs.xbox.com/ja-jp/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)

## 関連項目

[推奨されるローカル UDP マルチプレイヤー ポート](https://docs.xbox.com/ja-jp/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/ja-jp/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)\
[XNetworking](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasyncresult.md)
- [優先 UDP マルチプレイヤー ポート](https://docs.xbox.com/ja-jp/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworking (API の内容)](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/xnetworking_members.md)
- [Unity プロジェクトでの GDK API 用 C# ラッパーの使用](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)