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