> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConnectivityHint

> XNetworkingConnectivityHint

# XNetworkingConnectivityHint

ネットワーク接続レベル、データ制限、インターフェイスの種類、ネットワーク初期化状態など、ネットワークの現在のデバイス全体の状態を定義します。

## 構文

```cpp theme={null}
typedef struct XNetworkingConnectivityHint {
    XNetworkingConnectivityLevelHint connectivityLevel;
    XNetworkingConnectivityCostHint connectivityCost;
    uint32_t ianaInterfaceType;
    bool networkInitialized;
    bool approachingDataLimit;
    bool overDataLimit;
    bool roaming;
} XNetworkingConnectivityHint
```

### メンバー

*connectivityLevel*\
Type: [XNetworkingConnectivityLevelHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)

デバイスの現在のベスト エフォート接続レベル。

*connectivityCost*\
Type: [XNetworkingConnectivityCostHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)

デバイスのデータ制限の現在のベスト エフォート分類。

*ianaInterfaceType*\
Type: uint32\_t

インターネットに到達するために WinSock および WinHTTP で使用される可能性が高い現在のインターフェイスの種類。[IANA NDIS Interface Types](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types) のいずれか。

*networkInitialized*\
Type: bool

ネットワークが現在初期化されているかどうかを判定します。詳細については、[ネットワーク情報の取得](https://docs.xbox.com/ja-jp/build/console-features/networking/initialization-connectivity-networking.md) の [ネットワークの初期化](https://docs.xbox.com/ja-jp/build/console-features/networking/initialization-connectivity-networking.md) セクションを参照してください。

*approachingDataLimit*\
Type: bool

デバイスがデータ制限の超過に近づいているかどうかを判定します。

*overDataLimit*\
Type: bool

デバイスがデータ制限を超えているかどうかを判定します。

*roaming*\
Type: bool

デバイスがローミング中かどうかを判定します。

## 解説

ネットワーキングまたはセキュリティ API を使用する前に、*networkInitialized* メンバーが true を返すことを確認してください。

> [!NOTE]
>
> 初期化されていないネットワークで XNetworking API を使用しようとすると、呼び出しが失敗し、予測不可能な動作が発生します。

この構造体は、[XNetworkingGetConnectivityHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md) API と登録フローからのコールバックによって返されます。Microsoft Game Development Kit (GDK) タイトルにおけるネットワーク情報については、[ネットワーク情報の取得](https://docs.xbox.com/ja-jp/build/console-features/networking/initialization-connectivity-networking.md) を参照してください。

返される `XNetworkingConnectivityHint` 構造体のフィールド (`XNetworkingConnectivityHint::networkInitialized` フィールドを除く) はヒントです。これらは、デバイス上のネットワーク トラフィックの要約に基づいて、ネットワークの現在の状態についてデバイスが行うベスト エフォートの推測です。重要な点として、これらのフィールドは、特定のタイトル エンドポイントへの接続があるかどうかを表すものではありません。ネットワークの初期化を待った後、`XNetworkingConnectivityHint::connectivityLevelHint` フィールドの状態にかかわらず、WinSock または WinHTTP (あるいはその両方) を使用してエンドポイントへの接続を試みることをお勧めします。それらの API がその後失敗した場合は、`XNetworkingGetConnectivityHint` API を使用して、追加の UI や診断報告の目的で利用することをお勧めします。その後、ネットワーク接続レベルが変化するのを待ってから、再試行してください。

## 要件

**ヘッダー:** XNetworking.h

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

## 関連項目

[XNetworking](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingConnectivityCostHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)
- [XNetworkingGetConnectivityHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityLevelHint](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)
- [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/ja-jp/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)