次の方法で共有


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 本体

関連項目

XNetworking