Partager via


Champs de données du capteur de lumière

Cette rubrique fournit des informations sur les champs de données spécifiques au capteur de lumière.

Champs de données

Le tableau suivant montre les champs de données. Pour plus d’informations sur les types affichés dans la colonne de type, consultez Structure PROPVARIANT.

Clé de propriété Type Obligatoire ou facultatif Description
PKEY_SensorData_LightLevel_Lux VT_R4 Obligatoire Niveau d’éclairage en lux.
PKEY_SensorData_LightTemperature_Kelvins VT_R4 Facultatif La température de la lumière dans Kelvins.
PKEY_SensorData_LightChromaticityX VT_R4 Facultatif Coordonnée de couleur x sur le diagramme de chromaticité CIE 1931.
PKEY_SensorData_LightChromaticityY VT_R4 Facultatif Coordonnée de couleur y sur le diagramme de chromaticité CIE 1931.
PKEY_SensorData_IsValid VT_BOOL Facultatif Cette valeur doit être définie sur FALSE lorsque le capteur de lumière ambiante ne peut pas retourner un échantillon valide. Par exemple, cette valeur peut être définie sur FALSE lorsque le champ de vue du capteur est obstrué (par exemple lorsqu’un objet ou la main de l’utilisateur se trouve devant le capteur). Cette valeur doit être définie sur TRUE lorsque le capteur de lumière ambiante est en mesure de mesurer avec précision la lumière ambiante. Une conception matérielle appropriée doit essayer de réduire le temps et les scénarios nécessitant que cette valeur soit définie sur FALSE, car ce scénario empêche le système de contrôler correctement la luminosité. Sur un système idéal, cette valeur est toujours définie sur TRUE.