Partager via

À propos des constantes de capteur

  • Article

La plateforme Windows Sensor and Location 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 de capteurs. Les catégories vous permettent de regrouper des capteurs susceptibles de fournir des types d’informations similaires, ou qui sont liés d’une manière ou d’une autre. Chaque catégorie est représentée par une constante GUID . Par exemple, les capteurs qui signalent des coordonnées de latitude et de longitude appartiennent à la catégorie des capteurs d’emplacement. Cette valeur est représentée par la constante SENSOR_CATEGORY_LOCATION.
  • Les types de capteurs représentent des types spécifiques de capteurs. Chaque type de capteur s’intègre dans une catégorie particulière. Deux capteurs de types différents peuvent appartenir à la même catégorie ou à des catégories différentes. Chaque type de capteur est représenté par une constante GUID . Par exemple, un capteur de système de positionnement global est 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 des capteurs 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 de capteur peuvent contenir la valeur de mesure réelle, telle que l’altitude ; des 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 associés constitue un rapport de données. Les rapports de données sont empaquetés ensemble à 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 quand 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 du capteur doivent être fournies par le capteur, certaines propriétés peuvent être définies par les applications clientes et d’autres doivent toujours retourner la même valeur à partir 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 des GUID, qui représentent des types d’événements, et des PROPERTYKEY, qui représentent des types de paramètres d’événement. Vous allez utiliser 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.