ILampArray
RGB 照明対応デバイスを表します。 このオブジェクトは、ランプ数、寸法、製造元 ID、ランプの更新間隔 (ディスプレイのリフレッシュ レートと同様) など、デバイスの物理プロパティに関する情報を提供します。 ILampArray は、デバイスのランプの色と明るさを変更するためのメソッドも公開します。
構文
class ILampArray : public IUnknown
メソッド
| メソッド | 説明 |
|---|---|
| GetBoundingBox | ILampArray を含む論理 3D 境界ボックスを返します。 |
| GetBrightnessLevel | LampArray の全体的な輝度を取得します。 |
| GetDeviceId | ILampArray のシステム生成 ID を返します。 |
| GetHardwareVersion | ILampArray のハードウェア バージョン番号を取得します。 |
| GetIndicesCountForPurposes | 指定された LampPurposes のセットをサポートする Lamp インデックスの数を返します。 |
| GetIndicesForPurposes | 特定の LampPurposes セットをサポートする Lamp インデックスのバッファーを設定します。 |
| GetIsEnabled | 現在のプロセスの ILampArray の有効な状態を取得します。 |
| GetLampArrayKind | ILampArray によって表される物理デバイスの種類を返します。 |
| GetLampCount | この ILampArray の一部であるランプの数を返します。 |
| GetLampInfo | 指定したインデックス位置にある Lamp の ILampInfo を返します。 |
| GetMinUpdateIntervalInMicroseconds | デバイスがランプ状態を更新できる最小間隔を返します (デバイスによって報告されます)。 |
| GetProductId | ILampArray のハードウェア製品 ID を取得します。 |
| GetVendorId | ILampArray のハードウェア ベンダー番号を取得します。 |
| SetBrightnessLevel | ILampArray の全体的な輝度を設定します。 |
| SetColor | ILampArray のすべてのランプの色を設定します。 |
| SetColorsForIndices | 1 つ以上のランプの色を設定します。 |
| SetColorsForScanCodes | キーボード スキャン コードに対応する 1 つ以上のランプの色を設定します。 |
| SetIsEnabled | 現在のプロセスに対する ILampArray の有効な状態を取得します。 |
| SupportsScanCodes | LampArray がキーボード スキャン コードを使用したランプのターゲット設定をサポートしているかどうかを返します。 |
解説
基になるデバイスがシステムから切断された後も、アプリケーションは (意図的または意図せず) ILampArray インスタンスへの参照を保持し続ける可能性があります。 ILampArray インスタンスは有効なままですが、アプリケーションはインターフェイスへの参照を強制的に解放することはできないため、基になるオブジェクトは照会状態になります。
ゾンビ状態の場合、静的な構成情報またはデバイス状態情報を返す ILampArray インターフェイス上のメソッドは、呼び出し可能なままになります (一般に、Get* メソッド)。 ただし、接続されているデバイスのランプの色や明るさを変更するメソッドは無視されます。 同じ物理 LampArray が後でシステムに再接続されると、ゾンビ デバイス オブジェクトが再び復元され、ILampArray インスタンス上のすべてのメソッドが再び機能するようになります。
要件
ヘッダー: LampArray.h
サポートされているプラットフォーム: Xbox One ファミリー本体、Xbox Series 本体