Skip to main content

RegisterLampArrayStatusCallback

LampArray のステータスが変更されるたびに呼び出されるコールバック関数を登録します。

構文

パラメーター

callbackFunc   _In_ Type: LampArrayStatusCallback 登録する呼び出し元定義の関数です。LampArray のステータスが変更されると呼び出されます。 enumerationKind
Type: LampArrayEnumerationKind
LampArrayStatusCallback 関数の望ましいデバイス列挙動作を指定します。 context   _In_opt_
Type: void*
コールバック関数に関連する情報を含むオブジェクトへのポインター。通常は呼び出し元オブジェクトです。 callbackToken   _Out_ _Result_zeroonfailure_ Type: LampArrayCallbackToken* 後でコールバック関数の登録を解除するために使用できるトークン値です。

戻り値

Type: HRESULT 関数の結果です。

解説

LampArrayEnumerationKind パラメーターにより、呼び出し元は呼び出し時に接続されている LampArray デバイスに対してコールバックをどのように受信するかを指定できます。LampArrayEnumerationKind::Blocking が選択されている場合、RegisterLampArrayStatusCallback 関数は、接続されている各デバイスに対してコールバックが呼び出されるまでブロックします (つまり、コールバックは呼び出し元のスレッドで呼び出されます)。 最初のコールバックが登録されると、LampArray API はワーカー スレッドを起動して、ILampArray デバイスのステータス通知を処理します。これらのイベントは頻繁ではなく、ワーカー スレッドはそれ以外のときは待機状態のままです。登録呼び出しが返された後、後続のすべての LampArrayStatusCallbacks はこのワーカー スレッド上で順次呼び出されます。 LampArrayEnumerationKind::Async が指定されている場合、この呼び出しは即座に戻り、呼び出し時に接続されている LampArray は、前述の LampArray コールバック ワーカー スレッド上で列挙されます。 次のコードは、LampArrayStatusCallback 関数の登録と登録解除の例です。

要件

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

関連項目

Lighting API の概要
Lighting の基礎
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
最終更新日 2026年8月24日