XNetworkingConnectivityHint
ネットワーク接続レベル、データ制限、インターフェイスの種類、ネットワークの初期化状態など、デバイス全体のネットワークの状態を定義します。
構文
typedef struct XNetworkingConnectivityHint {
XNetworkingConnectivityLevelHint connectivityLevel;
XNetworkingConnectivityCostHint connectivityCost;
uint32_t ianaInterfaceType;
bool networkInitialized;
bool approachingDataLimit;
bool overDataLimit;
bool roaming;
} XNetworkingConnectivityHint
メンバー
connectivityLevel
型: XNetworkingConnectivityLevelHint
デバイスの現在のベストエフォートの接続レベル。
connectivityCost
型: XNetworkingConnectivityCostHint
デバイスの現在のベストエフォートのデータ制限分類。
ianaInterfaceType
型: uint32_t
インターネットにアクセスするために WinSock および WinHTTP によって使用される可能性が高い、現在のインターフェイスの種類。 IANA NDIS インターフェイスの種類の 1 つ。
networkInitialized
型: bool
ネットワークが現在初期化されているかどうかを判定します。 詳細については、「ネットワーク情報の取得」の「ネットワークの初期化」セクションを参照してください。
approachingDataLimit
型: bool
デバイスがデータ制限を超えそうになっているかどうかを判定します。
overDataLimit
型: bool
デバイスがデータ制限を超えたかどうかを判定します。
ローミング
型: bool
デバイスがローミングしているかどうかを判定します。
解説
ネットワークまたはセキュリティ API を使用する前に networkInitialized メンバーが必ず true を返すようにします。
注意
初期化されていないネットワークで XNetworking API を使用しようとすると、呼び出しが失敗し、予期しない動作が発生します。
この構造体は、XNetworkingGetConnectivityHint API およびレジスタ フローからのコールバックから返されます。 Microsoft Game Development Kit (GDK) タイトルにあるネットワーク情報については、「ネットワーク情報の取得」を参照してください。
返される XNetworkingConnectivityHint
構造体のフィールド (XNetworkingConnectivityHint::networkInitialized
フィールドを除く) はヒントです。 デバイスでのネットワーク トラフィックの概要に基づく、ネットワークの現在の状態についての、デバイスによるベストエフォートの推測です。 重要なのは、これらのフィールドは特定のタイトル エンドポイントへの接続があるかどうかを示すものではないということです。 ネットワークの初期化を待機した後、WinSock や WinHTTP を使用して、XNetworkingConnectivityHint::connectivityLevelHint
フィールドの状態に関係なくエンドポイントへの接続の確立を試みることをお勧めします。 後でこれらの API が失敗した場合は、追加の UI と診断レポートのために XNetworkingGetConnectivityHint
API を使用することをお勧めします。 その後、もう一度試す前に、ネットワーク接続レベルが変化するのを待つ必要があります。
要件
ヘッダー: XNetworking.h
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体