XNetworkingRegisterConnectivityHintChanged
現在のネットワーク接続レベル、データ制限、インターフェイスの種類、およびネットワーク初期化状態に関するデバイス全体の情報の変更に、タイトルを登録します。構文
パラメーター
queue _In_opt_型: XTaskQueueHandle 接続ヒントが変更されたときにコールバックを配置するキュー。 context _In_opt_
型: void* コールバックに渡すオプションのコンテキスト ポインター。 callback _In_
型: XNetworkingConnectivityHintChangedCallback* 接続ヒントが変更されたときに呼び出す関数。 token _Out_
型: XTaskQueueRegistrationToken* 登録解除時にコールバックを識別するために使用されるトークン。
戻り値
型: HRESULT HRESULT の成功またはエラー コード。解説
この関数は “接続ヒント変更” 通知を登録し、初期通知コールバックを送信します。 コールバックの登録を解除するには、XNetworkingUnregisterConnectivityHintChanged を使用してください。 返されるXNetworkingConnectivityHint 構造体のフィールド (XNetworkingConnectivityHint::networkInitialized フィールドを除く) はヒントです。これらは、デバイス上のネットワーク トラフィックの概要に基づく、ネットワークの現在の状態についてのデバイスによるベスト エフォートの推測です。重要な点として、これらのフィールドは特定のタイトル エンドポイントへの接続があるかどうかを表しません。ネットワーク初期化を待った後、XNetworkingConnectivityHint::connectivityLevelHint フィールドの状態に関係なく、WinSock や WinHTTP を使用してエンドポイントへの接続の確立を試みることをお勧めします。それらの API が失敗した場合は、追加の UI と診断レポートを目的として XNetworkingGetConnectivityHint API を使用することをお勧めします。その後、再試行する前にネットワーク接続レベルの変化を待つ必要があります。
ネットワークの初期化の詳細については、「ネットワークの初期化と接続」を参照してください。
このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間の影響を受けやすいコンテキストから呼び出しても安全です。
要件
ヘッダー: XNetworking.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ コンソール、XBOX Series コンソール関連項目
XNetworkingGetConnectivityHintXNetworkingUnregisterConnectivityHintChanged
XNetworking