Skip to main content

XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

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

構文

パラメーター

context   _In_opt_
型: void*
XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged 関数に渡された、オプションのコンテキスト ポインター。 preferredLocalUdpMultiplayerPort   _In_
型: uint16_t
ホスト順の、推奨されるローカル ユーザー データグラム プロトコル (UDP) マルチプレイヤー ポートへのポインター。

戻り値

型: void

解説

XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback は、タイトルが推奨されるローカル UDP マルチプレイヤー ポートの変更をリッスンする際に呼び出されます。タイトルの実行中に推奨されるローカル UDP マルチプレイヤー ポートが変更されないようにあらゆる努力が払われます。ただし、ユーザーの外部ネットワーク状態が変化し、既存のソケット フローが無効になることによってポートが変更される、避けられないケースがあります。ポートが変更される可能性が特に高いのは、ネットワーク接続レベルが変化するとき、またはタイトルのサスペンド/再開サイクルの一部として発生するときです。 詳細については、「推奨されるローカル ユーザー データグラム プロトコル (UDP) マルチプレイヤー ポート ネットワーク API」の「推奨されるローカル UDP マルチプレイヤー ポートの変更」セクションを参照してください。 このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間の影響を受けやすいコンテキストから呼び出しても安全です。

要件

ヘッダー: XNetworking.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ コンソール、XBOX Series コンソール

関連項目

XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
XNetworking
最終更新日 2026年8月24日