XNetworkingConnectivityHintChangedCallback

[アーティクル]
11/10/2023

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

構文

void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)

パラメーター

context _In_opt_
型: void*

XNetworkingRegisterConnectivityHintChanged 関数に渡されたオプションのコンテキストポインター。

connectivityHint _In_
型: XNetworkingConnectivityHint*

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

戻り値

型: void

解説

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

注意

ベストエフォートは、ネットワークとネットワーク接続レベルの現在のデバイス全体の状態に関連します。初期化は頻繁には発生しない可能性があるため、ネットワークの初期化はベストエフォートではないことを考慮する必要があります。

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

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

要件

ヘッダー: XNetworking.h

ライブラリ: xgameruntime.lib

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

次の方法で共有

XNetworkingConnectivityHintChangedCallback

構文

パラメーター

戻り値

解説

要件

関連項目

その他のリソース