Skip to main content

XGameStreamingRegisterConnectionStateChanged

ストリーミング クライアント デバイスの接続状態が変化した際に呼び出されるコールバックを登録します。登録時に、既に接続されているすべてのストリーミング クライアント デバイスに対してもコールバックが呼び出されます。

Syntax

Parameters

queue   _In_opt_
型: XTaskQueueHandle
変更コールバックを追加する非同期キューへのハンドル。 context   _In_opt_
型: void*
コールバック関数に渡されるコンテキストへの任意のポインター。 callback   _In_
型: XGameStreamingConnectionStateChangedCallback*
いずれかのストリーミング クライアント デバイスの接続状態が変化した際に呼び出されるコールバック関数。 token   _Out_
型: XTaskQueueRegistrationToken*
イベントの登録解除に使用できる登録トークンへのポインター。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

想定されるエラー

エラー コードの一覧については、Error Codes を参照してください。

Remarks

この関数は、時間制約のあるスレッドで呼び出すには安全ではありません。詳細については、時間制約のあるスレッドを参照してください。
この API は、ゲームがストリーミング クライアント デバイスごとにカスタマイズを行い、接続されているデバイスがあるかどうかに応じてゲームがエクスペリエンスを最適化できる状態を維持するための推奨される方法です。
登録時に、現在接続されているすべてのストリーミング クライアント デバイスに対してコールバックが呼び出されます。

Example

Requirements

ヘッダー: xgamestreaming.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
最終更新日 2026年8月24日