通过

光传感器数据字段

  • 项目

本主题提供有关特定于光传感器的数据字段的信息。

数据字段

下表显示了数据字段。 有关类型列中显示的类型的详细信息，请参阅 PROPVARIANT 结构。

属性键 类型 必需/可选 说明
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。