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

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

> XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

推奨されるローカル マルチプレイヤー ポートが変更されたときに呼び出されます。

## 構文

```cpp theme={null}
void XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback(
         void* context,
         uint16_t preferredLocalUdpMultiplayerPort
)
```

### パラメーター

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

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged) 関数に渡された、オプションのコンテキスト ポインター。

*preferredLocalUdpMultiplayerPort*   \_In\_\
型: uint16\_t

ホスト順の、推奨されるローカル ユーザー データグラム プロトコル (UDP) マルチプレイヤー ポートへのポインター。

### 戻り値

型: void

## 解説

`XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback` は、タイトルが推奨されるローカル UDP マルチプレイヤー ポートの変更をリッスンする際に呼び出されます。タイトルの実行中に推奨されるローカル UDP マルチプレイヤー ポートが変更されないようにあらゆる努力が払われます。ただし、ユーザーの外部ネットワーク状態が変化し、既存のソケット フローが無効になることによってポートが変更される、避けられないケースがあります。ポートが変更される可能性が特に高いのは、[ネットワーク接続レベル](/build/console-features/networking/initialization-connectivity-networking)が変化するとき、またはタイトルのサスペンド/再開サイクルの一部として発生するときです。

詳細については、「[推奨されるローカル ユーザー データグラム プロトコル (UDP) マルチプレイヤー ポート ネットワーク API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)」の「推奨されるローカル UDP マルチプレイヤー ポートの変更」セクションを参照してください。

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

## 要件

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

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

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

## 関連項目

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworking](/ja-jp/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/ja-jp/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)