光線感測器數據欄位

本主題提供光線感測器專屬之數據欄位的相關信息。

資料欄位

下表顯示數據欄位。如需類型數據行中顯示的類型詳細資訊，請參閱 PROPVARIANT 結構。

屬性索引鍵	類型	必要/選用	描述
PKEY_SensorData_LightLevel_Lux	VT_R4	必要	lux 中的亮度等級。
PKEY_SensorData_LightTemperature_Kelvins	VT_R4	選擇性	Kelvins 中的光線溫度。
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。