Compartilhar via


Campos de dados do sensor claro

Este tópico fornece informações sobre os campos de dados específicos do sensor de luz.

Campos de dados

A tabela a seguir mostra os campos de dados. Para obter mais informações sobre os tipos mostrados na coluna de tipo, consulte Estrutura PROPVARIANT.

Chave de propriedade Tipo Obrigatório/Opcional Descrição
PKEY_SensorData_LightLevel_Lux VT_R4 Obrigatório O nível de illuminância em lux.
PKEY_SensorData_LightTemperature_Kelvins VT_R4 Opcional A temperatura da luz em Kelvins.
PKEY_SensorData_LightChromaticityX VT_R4 Opcional A coordenada de cor x no diagrama de cromática do CIE 1931.
PKEY_SensorData_LightChromaticityY VT_R4 Opcional A coordenada de cor y no diagrama de cromática do CIE 1931.
PKEY_SensorData_IsValid VT_BOOL Opcional Esse valor deve ser definido como FALSE quando o sensor de luz ambiente não puder retornar nenhuma amostra válida no momento. Por exemplo, esse valor pode ser definido como FALSE quando o campo de exibição do sensor está obstruído (como quando um objeto ou a mão do usuário está na frente do sensor). Esse valor deve ser definido como TRUE quando o sensor de luz ambiente é capaz de medir com precisão a luz ambiente. O design de hardware adequado deve tentar minimizar o tempo e os cenários que exigem que esse valor seja definido como FALSE, pois esse cenário impede que o sistema controle corretamente o brilho. Em um sistema ideal, esse valor é sempre definido como TRUE.