XNetworkingConnectivityHintChangedCallback
接続ヒント構造体が変更されたときに呼び出されます。構文
パラメーター
context _In_opt_型: void* XNetworkingRegisterConnectivityHintChanged 関数に渡された、オプションのコンテキスト ポインター。 connectivityHint _In_
型: XNetworkingConnectivityHint* 新しいデバイス全体の接続ヒント構造体。
戻り値
型: void解説
このコールバック関数は、デバイスの現在の接続に何らかの変更があったときに呼び出されます。register 関数が呼び出された際に渡されたコンテキスト ポインターが含まれます。このコールバックのトリガーは、前回コールバックがトリガーされたときから何かが変更されたことを保証するものではありません。ベスト エフォートは、ネットワークとネットワーク接続レベルの現在のデバイス全体の状態に適用されます。ネットワーク初期化は、初期化がまれに発生しないことがあるため、ベスト エフォートではないことを尊重する必要があります。
XNetworkingConnectivityHint 構造体のフィールド (XNetworkingConnectivityHint::networkInitialized フィールドを除く) はヒントです。これらは、デバイス上のネットワーク トラフィックの概要に基づく、ネットワークの現在の状態についてのデバイスによるベスト エフォートの推測です。重要な点として、これらのフィールドは特定のタイトル エンドポイントへの接続があるかどうかを表しません。ネットワーク初期化を待った後、XNetworkingConnectivityHint::connectivityLevelHint フィールドの状態に関係なく、WinSock や WinHTTP を使用してエンドポイントへの接続の確立を試みることをお勧めします。それらの API が失敗した場合は、追加の UI と診断レポートを目的として XNetworkingGetConnectivityHint API を使用することをお勧めします。その後、再試行する前にネットワーク接続レベルの変化を待つ必要があります。
このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間の影響を受けやすいコンテキストから呼び出しても安全です。
要件
ヘッダー: XNetworking.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ コンソール、XBOX Series コンソール関連項目
ネットワーク情報の取得XNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking