RegisterLampArrayStatusCallback
LampArray のステータスが変更されるたびに呼び出されるコールバック関数を登録します。構文
パラメーター
callbackFunc _In_ Type: LampArrayStatusCallback 登録する呼び出し元定義の関数です。LampArray のステータスが変更されると呼び出されます。 enumerationKindType: 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
