À propos des constantes de capteur

La plateforme capteur et emplacement Windows utilise des constantes de plusieurs façons. La plateforme définit différentes constantes que vous pouvez utiliser dans votre code de pilote de capteur. Les fabricants de capteurs peuvent définir des constantes personnalisées. Vous trouverez les définitions des constantes définies par la plateforme dans le fichier Sensors.h. Pour plus d’informations sur les constantes de capteur définies par la plateforme, consultez Constantes.

Organisation des capteurs et des données

La plateforme organise les capteurs et les données de la manière suivante.

• Les catégories représentent de larges classes d’appareils de capteur. Les catégories vous permettent de regrouper des capteurs susceptibles de fournir des types d’informations similaires ou d’être associés d’une certaine manière. Chaque catégorie est représentée par une constante GUID . Par exemple, les capteurs qui signalent les coordonnées de latitude et de longitude appartiennent à la catégorie de capteur d’emplacement. Ceci est représenté par la constante SENSOR_CATEGORY_LOCATION.
• Les types de capteurs représentent des types spécifiques de capteurs. Chaque type de capteur s’inscrit dans une catégorie particulière. Deux capteurs de types différents peuvent appartenir à la même catégorie ou à différentes catégories. Chaque type de capteur est représenté par une constante GUID. Par exemple, un capteur de système de positionnement global serait identifié par la constante SENSOR_TYPE_LOCATION_GPS. Toutefois, un capteur qui fournit l’emplacement actuel à l’aide d’une adresse IP est identifié par la constante SENSOR_TYPE_LOCATION_LOOKUP. Toutefois, les deux capteurs appartiennent à la catégorie de capteur d’emplacement.
• Les types de données représentent des types d’informations spécifiques que le capteur peut fournir. Les types de données du capteur peuvent contenir la valeur de mesure réelle, telle que l’altitude ; informations sur les unités utilisées pour exprimer les données, telles que les compteurs ; et des points de référence pour les données, comme le niveau de la mer. Chaque type de données est représenté par une constante PROPERTYKEY. Par exemple, le type de données qui représente l’altitude au-dessus du niveau de la mer, en mètres, serait identifié par la constante SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Lors de la création de rapports de données, une valeur est dite contenue dans un champ de données et une collection de champs de données connexes compose un rapport de données. Les rapports de données sont regroupés à l’aide de l’interface IPortableDeviceValues. Chaque rapport de données doit contenir au moins un champ de données valide et un horodatage qui identifie le moment où le rapport de données a été créé. Les horodatages sont représentés par la constante SENSOR_DATA_TYPE_TIMESTAMP.

Autres constantes

Votre programme doit également utiliser d’autres constantes. Ces constantes sont les suivantes :

• Propriétés du capteur, telles que SENSOR_PROPERTY_DESCRIPTION. En règle générale, ces constantes sont utilisées pour décrire un capteur. Certaines propriétés de capteur doivent être fournies par le capteur, certaines propriétés peuvent être définies par les applications clientes, et certaines doivent toujours retourner la même valeur du capteur. La section de référence Propriétés du capteur fournit ces informations pour chaque propriété.
• Constantes d’événement, telles que SENSOR_EVENT_STATE_CHANGED. Les constantes d’événement incluent GUIDs, qui représentent des types d’événements et PROPERTYKEYs, qui représentent des types de paramètres d’événement. Vous utiliserez ces constantes pour les appels de méthode, tels que ISensor ::SetEventInterest et ISensor ::GetEventInterest.

Constantes personnalisées

Les fabricants de capteurs peuvent définir des constantes personnalisées. Par exemple, un capteur peut appartenir à une catégorie non définie par la plateforme. Avant de pouvoir utiliser un capteur qui définit des constantes personnalisées, le fabricant du capteur doit publier les valeurs, par exemple en publiant un fichier d’en-tête. Pour plus d’informations, consultez la documentation fournie avec le capteur.