次の方法で共有

XNetworkingGetConnectivityHint

  • [アーティクル]

現在のネットワーク接続レベル、データ制限、インターフェイスの種類、ネットワークの初期化状態に関するデバイス全体の情報をクエリします。

構文

HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)

パラメーター

connectivityHint _Out_
型: XNetworkingConnectivityHint*

デバイス全体の現在のネットワークの状態。

戻り値

型: HRESULT

HRESULT 成功またはエラー コード。

解説

この関数では、ネットワーク接続レベル、データ制限、ワイヤードとワイヤレスの接続、ネットワークが初期化されているかどうかに関するデバイス全体の情報が返されます。 XNetworkingRegisterConnectivityHintChanged 関数と XNetworkingUnregisterConnectivityHintChanged 関数で、変更をリッスンできます。

返される XNetworkingConnectivityHint 構造体のフィールド (XNetworkingConnectivityHint::networkInitialized フィールドを除く) はヒントです。 デバイスでのネットワーク トラフィックの概要に基づく、ネットワークの現在の状態についての、デバイスによるベストエフォートの推測です。 重要なのは、これらのフィールドは特定のタイトル エンドポイントへの接続があるかどうかを示すものではないということです。 ネットワークの初期化を待機した後、WinSock や WinHTTP を使用して、XNetworkingConnectivityHint::connectivityLevelHint フィールドの状態に関係なくエンドポイントへの接続の確立を試みることをお勧めします。 後でこれらの API が失敗した場合は、追加の UI と診断レポートのために XNetworkingGetConnectivityHint API を使用することをお勧めします。 その後、もう一度試す前に、ネットワーク接続レベルが変化するのを待つ必要があります。

ネットワークの初期化の詳細については、「ネットワークの初期化と接続」を参照してください。

これらのメソッドは、呼び出し元プロセス内のローカル状態を調査して迅速に戻るので、時間に依存するコンテキストから安全に呼び出すことができます。

要件

ヘッダー: XNetworking.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
ネットワーク初期化状態の検出
XNetworking