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

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

> XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

推奨されるローカル UDP マルチプレイヤー ポートが変更されたときに呼び出されるコールバック関数を登録します。

## 構文

```cpp theme={null}
HRESULT XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### パラメーター

*queue*   \_In\_opt\_\
Type: XTaskQueueHandle

コールバックを登録するキュー。キューの作業側と完了側の両方が使用されます。

*context*   \_In\_opt\_\
Type: void\*

コールバックに渡すオプションのコンテキスト ポインター。

*callback*   \_In\_\
Type: [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback)\*

推奨ポートが変更されたときに呼び出されるコールバック関数。

*token*   \_Out\_\
Type: [XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

[XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged) を呼び出す際にコールバックを識別するために使用されるトークン。

### 戻り値

Type: HRESULT

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

## 解説

推奨されるローカル UDP (User Datagram Protocol) マルチプレイヤー ポートの変更通知を登録すると、常に初回の通知コールバックが発生します。

タイトルの実行中は推奨されるローカル UDP マルチプレイヤー ポートが変更されないようにあらゆる措置が取られます。ただし、ユーザーの外部ネットワーク条件の変化により既存のソケット フローが無効化されるなど、ポートが変更される避けられないケースがあります。特に、[ネットワーク接続レベル](/build/console-features/networking/initialization-connectivity-networking)が変化したときや、タイトルの中断/再開サイクルの一環として、ポートが変更される可能性が高くなります。

推奨されるローカル UDP マルチプレイヤー ポートが変更されると、以前の推奨ポートでは将来のピアからの新規受信接続がブロックされる可能性があります。これはソケット層で障害を引き起こすとは限りませんが、以前の推奨ポートにバインドされたソケットで、タイトルが最終的にパケットを受信できなくなる可能性があります。

既存のピアとの間で送受信されるパケットは引き続き機能する場合があるため、推奨されるローカル UDP マルチプレイヤー ポートの変更通知が、進行中のゲーム セッションにとって致命的でない場合もあります。

変更通知が発生した場合、タイトルは既存のゲームプレイを中断することなく、可能な限り早期に新しい推奨ポートにバインドされた新しいソケットに移行する必要があります。タイトルが接続の切断を検出してソケット接続を再試行する場合は、常に最新の推奨ポートを使用してください。

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

## 要件

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

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

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ本体および XBOX Series 本体

## 概念ドキュメント

* [推奨 UDP マルチプレイヤー ポート](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## 関連項目

[推奨されるローカル UDP マルチプレイヤー ポート ネットワーキング API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/ja-jp/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [優先ローカル UDP マルチプレイヤー ポート ネットワーキング API](/ja-jp/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworking](/ja-jp/reference/networking/xnetworking/xnetworking_members.md)