Propriétés du capteur
La plate-forme capteur et emplacement 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 de 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é GUID de propriété de capteur _ _ _ :
{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 obligatoires doivent être prises en charge par le capteur.
| Nom de la clé de propriété et PID | Description |
|---|---|
|
VT _ inconnu Lecture seule. Objet IPortableDeviceValues qui contient les noms des 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 True. Les valeurs de précision sont exprimées en utilisant les mêmes unités que le champ de données, sauf indication contraire. |
|
VT _ inconnu En lecture/écriture. Objet IPortableDeviceValues qui contient les noms des types de données de capteur et leurs valeurs de sensibilité de modification associées. Modifier les valeurs de sensibilité fournit des demandes relatives à la quantité de données que le champ de données doit modifier avant le déclenchement de l' _ _ événement de _ mise à jour des données d’événement de capteur. 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é de la modification est interprétée comme une valeur réelle. Par exemple, une valeur de sensibilité de modification de 2 pour le type de données de capteur _ _ _ température _ Celsius représente une sensibilité de plus ou moins 2 degrés Celsius. Pour les autres capteurs, comme le capteur de lumière ambiante (ALS), le changement de sensibilité est interprété comme un pourcentage. Ainsi, une modification de la sensibilité de 2 pour le type de données de capteur de _ _ niveau de _ lumière _ _ Lux représente plus ou moins 2% de Lux. Vous pouvez définir cette valeur pour demander un critère de modification particulier, mais plusieurs applications peuvent utiliser le même capteur. Par conséquent, les capteurs déterminent le véritable respect de la modification, en fonction de leur logique interne. Par exemple, le capteur peut toujours utiliser le plus petit critère de modification qui est demandé par l’une des applications. Si une application définit cette propriété sur VT _ null, le pilote de périphérique réinitialise la _ _ sensibilité du changement _ de propriété de capteur à 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 de rapports de données de capteur, en millisecondes. Si vous affectez la valeur zéro, le pilote utilise son intervalle de rapport par défaut. Après avoir reçu une valeur de 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 applicationscould utilisent 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 bref demandé par un appelant. Pour obtenir un exemple d’utilisation de cette propriété, consultez utilisation des événements de l’API de capteur. |
|
_LPWStr VT Lecture seule. Chaîne de description du capteur. |
|
_LPWStr VT Lecture seule. Identifie de façon unique l’instance d’appareil à laquelle 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. |
|
_LPWStr VT Lecture seule. Obligatoire, static. 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 couvre la couche API avec le nom convivial « inconnu ». |
|
VT _ UI1 VT Vector | _ Lecture seule. Tableau compté qui contient des paires de valeurs qui fournissent un mappage entre les niveaux d’éclairage ambiant et les décalages. Ces valeurs sont exprimées sous forme de pourcentages. la fonctionnalité de luminosité adaptative de Windows applique ces valeurs à la préférence de luminosité de l’affichage actuel de l’utilisateur. Les données des types vectoriels sont toujours sérialisées en tant que VT _ UI1 (un tableau de caractères non signés, de 1 octet). Cette propriété contient en fait chaque valeur en tant qu’entier non signé de 4 octets (VT _ UI4). Pour plus d’informations sur l’utilisation des tableaux, consultez récupération des types de vecteurs. |
|
VT _ UI4 En lecture/écriture. Valeur de l’énumération de _ _ précision souhaitée de l’emplacement qui indique le type de gestion de la précision demandé par une application cliente. Emplacement _ _ _ Valeur par défaut de précision souhaitée (0) indique que le capteur doit utiliser la précision pour laquelle il peut optimiser l’utilisation de l’alimentation et d’autres considérations relatives aux coûts. Emplacement _ La _ précision souhaitée _ élevée (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. |
|
_LPWStr VT Lecture seule. Obligatoire, static. Nom du fabricant. |
|
VT _ UI4 Lecture seule. Obligatoire, static. Intervalle minimal que le matériel prend en charge pour la génération de rapports de données de capteur, en millisecondes. |
|
_LPWStr VT Lecture seule. Obligatoire, static. Nom du modèle de capteur. |
|
_CLSID VT Lecture seule. Obligatoire, static. 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 . |
|
_inconnue VT Lecture seule. Objet IPortableDeviceValues qui contient les noms de champs de données de capteur et leurs valeurs maximales associées. |
|
_inconnue VT Lecture seule. Objet IPortableDeviceValues qui contient les noms de champs de données de capteur et leurs valeurs minimales associées. |
|
_inconnue VT Lecture seule. Objet IPortableDeviceValues qui contient les noms de champs de données de capteur et leurs résolutions associées. Les valeurs de résolution représentent la sensibilité à modifier 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 en cas de document documenté. |
|
_LPWStr VT Lecture seule. Obligatoire, static. Numéro de série du capteur. |
|
VT _ UI4 Lecture seule. Obligatoire. Valeur SensorState qui contient l’état actuel du capteur. |
|
_CLSID VT Lecture seule. Obligatoire, static. 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é des appareils mobiles (WPD) Windows suivante doit être prise en charge par tous les capteurs.
| Clé de propriété | Description |
|---|---|
|
_CLSID VT Lecture seule. Obligatoire, static. Définit la catégorie de capteur. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
applications de [ bureau Windows 7 uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|