Propriétés du capteur
La plateforme Sensor and Location définit des constantes qui identifient les propriétés des capteurs. Les fabricants de capteurs peuvent également définir leurs propres propriétés.
La plateforme définit les valeurs PROPERTYKEY suivantes pour les propriétés du capteur. Ces propriétés sont en lecture seule, sauf indication contraire.
Chaque propriété de capteur définie par la plateforme PROPERTYKEY est basée sur un GUID commun nommé SENSOR_PROPERTY_COMMON_GUID :
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Important
N’utilisez pas cette valeur de base pour définir vos propres clés de propriété.
Les valeurs des propriétés désignées en lecture/écriture peuvent être spécifiées par l’application cliente. Les valeurs des propriétés désignées comme statiques ne doivent pas changer au fil du temps. Les propriétés désignées comme requises doivent être prises en charge par le capteur.
| Nom de clé de propriété et PID | Description |
|---|---|
|
VT_UNKNOWN Lecture seule. Objet IPortableDeviceValues qui contient des noms de types de données de capteur et leurs précisions associées. Les valeurs de précision représentent une variation possible par rapport aux valeurs vraies. Les valeurs de précision sont exprimées en utilisant les mêmes unités que le champ de données, sauf si elles sont documentées. |
|
VT_UNKNOWN En lecture/écriture. Objet IPortableDeviceValues qui contient des noms de types de données de capteur et leurs valeurs de sensibilité de modification associées. Les valeurs de sensibilité de modification fournissent des requêtes sur la quantité de modification du champ de données avant que l’événement SENSOR_EVENT_DATA_UPDATED ne soit déclenché. Les valeurs de sensibilité sont exprimées en utilisant les mêmes unités que le champ de données, sauf indication contraire. Pour certains capteurs, la sensibilité au changement est interprétée comme une valeur réelle. Par exemple, une valeur de sensibilité au changement de 2 pour SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS représente une sensibilité de plus ou moins 2 degrés Celsius. Pour d’autres capteurs, comme le capteur de lumière ambiante (ALS), la sensibilité au changement est interprétée comme un pourcentage. Ainsi, une sensibilité au changement de 2 pour SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX représente plus ou moins 2 % de LUX. Vous pouvez définir cette valeur pour demander une sensibilité de modification particulière, mais plusieurs applications peuvent utiliser le même capteur. Par conséquent, les capteurs déterminent la véritable sensibilité au changement, en fonction de leur logique interne. Par exemple, le capteur peut toujours utiliser la plus petite sensibilité aux modifications demandée par l’une des applications. Si une application définit cette propriété sur VT_NULL, le pilote de périphérique réinitialise SENSOR_PROPERTY_CHANGE_SENSITIVITY à sa valeur par défaut. |
|
VT_UI4 Lecture seule. Valeur SensorConnectionType qui contient le type de connexion actuel. |
|
VT_UI4 En lecture/écriture. Temps écoulé actuel pour la génération du rapport de données de capteur, en millisecondes. La définition d’une valeur zéro indique au pilote d’utiliser son intervalle de rapport par défaut. Après avoir reçu la valeur zéro pour cette propriété, un pilote doit retourner son intervalle de rapport par défaut, et non zéro, lorsqu’il est interrogé. Les applications peuvent définir cette valeur pour demander un intervalle de rapport particulier, mais plusieurs applications peuvent utiliser le même pilote. Par conséquent, les pilotes déterminent l’intervalle de rapport réel, en fonction de la logique interne. Par exemple, le pilote peut toujours utiliser l’intervalle de rapport le plus court demandé par n’importe quel appelant. Pour obtenir un exemple d’utilisation de cette propriété, consultez Utilisation des événements d’API de capteur. |
|
VT_LPWSTR Lecture seule. Chaîne de description du capteur. |
|
VT_LPWSTR Lecture seule. Identifie de manière unique l’appareil instance auquel le capteur est associé. Vous pouvez utiliser cette propriété pour déterminer si un appareil contient plusieurs capteurs. Les pilotes de périphérique n’ont pas besoin de prendre en charge cette propriété, car la plateforme fournit cette valeur aux applications sans interroger les pilotes. |
|
VT_LPWSTR Lecture seule. Obligatoire, statique. Nom convivial de l’appareil. |
|
VT_UI4 Lecture seule. Cette propriété est fournie afin que les fabricants de capteurs HID et les développeurs de pilotes aient un moyen d’identifier un capteur qui apparaît dans la couche API avec un nom convivial « inconnu ». |
|
VT_VECTOR| VT_UI1 Lecture seule. Tableau compté qui contient des paires de valeurs qui fournissent un mappage entre les niveaux de lumière ambiante et les décalages. Ces valeurs sont exprimées sous forme de pourcentages. La fonctionnalité de luminosité adaptative dans Windows applique ces valeurs à la préférence de luminosité d’affichage actuelle de l’utilisateur. Les données des types vectoriels sont toujours sérialisées en tant que VT_UI1 (tableau de caractères non signés de 1 octet). Cette propriété contient en fait chaque valeur sous la forme d’un entier non signé de 4 octets (VT_UI4). Pour plus d’informations sur l’utilisation des tableaux, consultez Récupération de types de vecteurs. |
|
VT_UI4 En lecture/écriture. Valeur de l’énumération LOCATION_DESIRED_ACCURACY qui indique le type de gestion de la précision demandée par une application cliente. LOCATION_DESIRED_ACCURACY_DEFAULT (0) indique que le capteur doit utiliser la précision pour laquelle il peut optimiser la consommation d’énergie et d’autres considérations de coût. LOCATION_DESIRED_ACCURACY_HIGH (1) indique que le capteur doit fournir le rapport le plus précis possible. Cela inclut l'utilisation des services qui peuvent facturer des sommes d'argent ou la consommation de niveaux supérieurs d'alimentation de batterie ou de bande passante de connexion. |
|
VT_LPWSTR Lecture seule. Obligatoire, statique. Nom du fabricant. |
|
VT_UI4 Lecture seule. Obligatoire, statique. Intervalle minimal pris en charge par le matériel pour la génération de rapports de données de capteur, en millisecondes. |
|
VT_LPWSTR Lecture seule. Obligatoire, statique. Nom du modèle de capteur. |
|
VT_CLSID Lecture seule. Obligatoire, statique. GUID qui identifie le capteur. Cette valeur doit être unique pour chaque capteur sur un appareil, ou sur plusieurs appareils du même modèle que celui énuméré sur l’ordinateur. Cette propriété contient la même valeur obtenue en appelant ISensor::GetID . |
|
VT_UKNOWN Lecture seule. Objet IPortableDeviceValues qui contient des noms de champs de données de capteur et leurs valeurs maximales associées. |
|
VT_UKNOWN Lecture seule. Objet IPortableDeviceValues qui contient des noms de champs de données de capteur et leurs valeurs minimales associées. |
|
VT_UKNOWN Lecture seule. Objet IPortableDeviceValues qui contient des noms de champs de données de capteur et leurs résolutions associées. Les valeurs de résolution représentent la sensibilité au changement dans le champ de données. Les valeurs de résolution sont exprimées en utilisant les mêmes unités que le champ de données, sauf indication contraire. |
|
VT_LPWSTR Lecture seule. Obligatoire, statique. Numéro de série du capteur. |
|
VT_UI4 Lecture seule. Obligatoire. Valeur SensorState qui contient l’état actuel du capteur. |
|
VT_CLSID Lecture seule. Obligatoire, statique. GUID qui identifie le type de capteur. Les types de capteurs définis par la plateforme sont définis dans Sensors.h. |
La propriété Windows Portable Devices (WPD) suivante doit être prise en charge par tous les capteurs.
| Clé de propriété | Description |
|---|---|
|
VT_CLSID Lecture seule. Obligatoire, statique. Définit la catégorie de capteur. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
Voir aussi