次の方法で共有

光センサー データ フィールド

  • [アーティクル]

このトピックでは、光センサーに固有のデータフィールドを説明します。

データ フィールド

次のテーブルには、データ フィールドが掲載されています。 型列に記載されている型の詳細については、「PROPVARIANT 構造体」を参照してください。

プロパティ キー Type 必須/オプション 説明
PKEY_SensorData_LightLevel_Lux VT_R4 必須 ルクス単位の照度レベル。
PKEY_SensorData_LightTemperature_Kelvins VT_R4 省略可能 ケルビン単位の光温度。
PKEY_SensorData_LightChromaticityX VT_R4 省略可能 CIE 1931 色度図上の x 色の座標。
PKEY_SensorData_LightChromaticityY VT_R4 省略可能 CIE 1931 色度図上の y 色の座標。
PKEY_SensorData_IsValid VT_BOOL 省略可能 環境光センサーが現在有効なサンプルを返せない場合、この値を FALSE に設定する必要があります。 例えば、センサーの視野が遮られている場合 (物体やユーザーの手がセンサーの前にある場合など)、この値は FALSE に設定される。 環境光センサーが周囲光を正確に測定できる場合は、この値を TRUE に設定する必要があります。 このようなシナリオではシステムが明るさを適切に制御できなくなるため、適切なハードウェア設計で、この値を FALSE に設定するのに必要な時間とシナリオの数を最小限に抑えようとする必要があります。 理想的なシステムでは、この値は常に TRUE に設定されます。