光传感器数据字段

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

数据字段

下表显示了数据字段。有关类型列中显示的类型的详细信息，请参阅 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。