Skip to main content

XGameStreamingRegisterClientPropertiesChanged

いずれかのストリーミング クライアント デバイスのプロパティが変更された際に呼び出されるコールバックを登録します。
登録時に、クライアント デバイスの現在のクライアント プロパティに対してコールバックが呼び出されます。

Syntax

Parameters

client   _In_
型: XGameStreamingClientId
コールバックを受け取るために登録するゲーム ストリーミング クライアントの ID。 queue   _In_opt_
型: XTaskQueueHandle
変更コールバックを追加する非同期キューへのハンドル。 context   _In_opt_
型: void*
コールバック関数に渡されるコンテキストへの任意のポインター。 callback   _In_
型: XGameStreamingClientPropertiesChangedCallback*
クライアントのプロパティが変更されたときに呼び出されるコールバック関数。 token   _Out_
型: XTaskQueueRegistrationToken*
イベントの登録解除に使用できる登録トークンへのポインター。

Return value

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

想定されるエラー

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

Remarks

この関数は、時間制約のあるスレッドで呼び出すには安全ではありません。詳細については、時間制約のあるスレッドを参照してください。
この API を使用すると、ストリームの物理的な寸法などの XGameStreamingClientProperty が変更されたときに、ゲームが XGameStreamingClientPropertiesChangedCallback を受け取れるようになります。 登録により、該当するすべての XGameStreamingClientProperty に対してコールバックが 呼び出されます。これにより、現在のプロパティの詳細を照会できます。 ストリーミング クライアント デバイスが切断されたら、XGameStreamingUnregisterClientPropertiesChanged を使用してコールバックの登録を解除してください。

Example

Requirements

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

Conceptual documentation

See also

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
最終更新日 2026年8月24日