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

# XNetworkingConnectivityHintChangedCallback

> XNetworkingConnectivityHintChangedCallback

# XNetworkingConnectivityHintChangedCallback

接続ヒント構造体が変更されたときに呼び出されます。

## 構文

```cpp theme={null}
void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)
```

### パラメーター

*context*   \_In\_opt\_\
型: void\*

[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) 関数に渡された、オプションのコンテキスト ポインター。

*connectivityHint*   \_In\_\
型: [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

新しいデバイス全体の接続ヒント構造体。

### 戻り値

型: void

## 解説

このコールバック関数は、デバイスの現在の接続に何らかの変更があったときに呼び出されます。register 関数が呼び出された際に渡されたコンテキスト ポインターが含まれます。このコールバックのトリガーは、前回コールバックがトリガーされたときから何かが変更されたことを保証するものではありません。

<Note>ベスト エフォートは、ネットワークとネットワーク接続レベルの現在のデバイス全体の状態に適用されます。ネットワーク初期化は、初期化がまれに発生しないことがあるため、ベスト エフォートではないことを尊重する必要があります。</Note>

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

このメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間の影響を受けやすいコンテキストから呼び出しても安全です。

## 要件

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

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ コンソール、XBOX Series コンソール

## 関連項目

[ネットワーク情報の取得](/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingUnregisterConnectivityHintChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworking](/ja-jp/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingGetConnectivityHint](/ja-jp/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityHint](/ja-jp/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)