Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Utilisez plutôt l’API de capteur UWP .
L’API de capteur COM est déconseillée et ne doit pas être utilisée dans les nouvelles applications. Aucune fonctionnalité ou amélioration supplémentaire n’est planifiée et la prise en charge sera limitée.
La plateforme 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 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 obligatoires doivent être prises en charge par le capteur.
| Nom de clé de propriété et PID | Descriptif |
|---|---|
|
VT_UNKNOWN En 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 la variation possible des valeurs vraies. Les valeurs de précision sont exprimées à l’aide des mêmes unités que le champ de données, sauf dans le cas contraire documenté. |
|
VT_UNKNOWN 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 confidentialité modifiées fournissent des requêtes sur la quantité par laquelle le champ de données doit changer avant que l’événement de SENSOR_EVENT_DATA_UPDATED soit déclenché. Les valeurs de confidentialité sont exprimées à l’aide des mêmes unités que le champ de données, sauf dans le cas contraire documenté. Pour certains capteurs, la sensibilité des modifications est interprétée comme une valeur réelle. Par exemple, une valeur de sensibilité modifiée 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é des changements est interprétée comme un pourcentage. Par conséquent, une sensibilité de modification 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é particulière des modifications, mais plusieurs applications peuvent utiliser le même capteur. Par conséquent, les capteurs déterminent la sensibilité réelle des changements en fonction de leur logique interne. Par exemple, le capteur peut toujours utiliser la plus petite sensibilité de modification 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 En lecture seule. Valeur SensorConnectionType qui contient le type de connexion actuel. |
|
VT_UI4 Lecture/écriture. Temps écoulé actuel pour la génération de rapports de données du capteur, en millisecondes. La définition d’une valeur zéro signale 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 doivent utiliser le même pilote. Par conséquent, les pilotes déterminent l’intervalle de rapport vrai, 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 sensor. |
|
VT_LPWSTR En lecture seule. Chaîne de description du capteur. |
|
VT_LPWSTR En lecture seule. Identifie de manière unique l’instance de l’appareil avec 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. |
|
VT_LPWSTR En lecture seule. Obligatoire, statique. Nom convivial de l’appareil. |
|
VT_UI4 En 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 se trouve dans la couche API avec un nom convivial « inconnu ». |
|
VT_VECTOR|VT_UI1 En 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 pour les types de vecteurs sont toujours sérialisées en tant que VT_UI1 (tableau de caractères non signés, de 1 octets). 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 des types de vecteurs. |
|
VT_UI4 Lecture/écriture. Valeur de l’énumération LOCATION_DESIRED_ACCURACY qui indique le type de gestion de précision demandé par une application cliente. LOCATION_DESIRED_ACCURACY_DEFAULT (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. LOCATION_DESIRED_ACCURACY_HIGH (1) indique que le capteur doit fournir le rapport le plus précis possible. Cela inclut l’utilisation de services qui peuvent facturer de l’argent, ou consommer des niveaux plus élevés d’alimentation de batterie ou de bande passante de connexion. |
|
VT_LPWSTR En lecture seule. Obligatoire, statique. Nom du fabricant. |
|
VT_UI4 En 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 En lecture seule. Obligatoire, statique. Nom du modèle de capteur. |
|
VT_CLSID En lecture seule. Obligatoire, statique. GUID qui identifie le capteur. Cette valeur doit être unique pour chaque capteur sur un appareil, ou sur les appareils du même modèle que ceux énumérés sur l’ordinateur. Cette propriété contient la même valeur obtenue en appelant ISensor ::GetID . |
|
VT_UKNOWN En lecture seule. Objet IPortableDeviceValues qui contient des noms de champs de données de capteur et leurs valeurs maximales associées. |
|
VT_UKNOWN En lecture seule. Objet IPortableDeviceValues qui contient des noms de champs de données de capteur et leurs valeurs minimales associées. |
|
VT_UKNOWN En 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é à modifier dans le champ de données. Les valeurs de résolution sont exprimées à l’aide des mêmes unités que le champ de données, sauf dans le cas contraire documenté. |
|
VT_LPWSTR En lecture seule. Obligatoire, statique. Numéro de série du capteur. |
|
VT_UI4 En lecture seule. Obligatoire. Valeur SensorState qui contient l’état actuel du capteur. |
|
VT_CLSID En 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é WPD (Windows Portable Devices) suivante doit être prise en charge par tous les capteurs.
| Clé de propriété | Descriptif |
|---|---|
|
VT_CLSID En lecture seule. Obligatoire, statique. Définit la catégorie de capteur. |
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimum pris en charge |
Aucun pris en charge |
| Header |
|