XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
推奨されるローカル UDP マルチプレイヤー ポートが変更されたときに呼び出されるコールバック関数を登録します。構文
パラメーター
queue _In_opt_Type: XTaskQueueHandle コールバックを登録するキュー。キューの作業側と完了側の両方が使用されます。 context _In_opt_
Type: void* コールバックに渡すオプションのコンテキスト ポインター。 callback _In_
Type: XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* 推奨ポートが変更されたときに呼び出されるコールバック関数。 token _Out_
Type: XTaskQueueRegistrationToken* XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged を呼び出す際にコールバックを識別するために使用されるトークン。
戻り値
Type: HRESULT HRESULT の成功またはエラー コード。解説
推奨されるローカル UDP (User Datagram Protocol) マルチプレイヤー ポートの変更通知を登録すると、常に初回の通知コールバックが発生します。 タイトルの実行中は推奨されるローカル UDP マルチプレイヤー ポートが変更されないようにあらゆる措置が取られます。ただし、ユーザーの外部ネットワーク条件の変化により既存のソケット フローが無効化されるなど、ポートが変更される避けられないケースがあります。特に、ネットワーク接続レベルが変化したときや、タイトルの中断/再開サイクルの一環として、ポートが変更される可能性が高くなります。 推奨されるローカル UDP マルチプレイヤー ポートが変更されると、以前の推奨ポートでは将来のピアからの新規受信接続がブロックされる可能性があります。これはソケット層で障害を引き起こすとは限りませんが、以前の推奨ポートにバインドされたソケットで、タイトルが最終的にパケットを受信できなくなる可能性があります。 既存のピアとの間で送受信されるパケットは引き続き機能する場合があるため、推奨されるローカル UDP マルチプレイヤー ポートの変更通知が、進行中のゲーム セッションにとって致命的でない場合もあります。 変更通知が発生した場合、タイトルは既存のゲームプレイを中断することなく、可能な限り早期に新しい推奨ポートにバインドされた新しいソケットに移行する必要があります。タイトルが接続の切断を検出してソケット接続を再試行する場合は、常に最新の推奨ポートを使用してください。 このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に戻るため、時間的制約のあるコンテキストからも安全に呼び出すことができます。要件
ヘッダー: XNetworking.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体概念ドキュメント
関連項目
推奨されるローカル UDP マルチプレイヤー ポート ネットワーキング APIXNetworking