Acerca de las constantes del sensor

Importante

En su lugar, usa la API de sensores de UWP.

La API de sensor basada en COM está en desuso y no debe usarse en nuevas aplicaciones. No se planean características ni mejoras adicionales y el soporte técnico será limitado.

La plataforma sensor y ubicación de Windows usa constantes de muchas maneras. La plataforma define diferentes constantes que puede usar en el código del controlador del sensor. Los fabricantes de sensores pueden definir constantes personalizadas. Puede encontrar las definiciones de constantes definidas por la plataforma en el archivo Sensors.h. Para obtener información detallada sobre las constantes de sensor definidas por la plataforma, consulte Constantes.

Sensor y organización de datos

La plataforma organiza sensores y datos de las maneras siguientes.

• Las categorías representan clases amplias de dispositivos de sensor. Las categorías permiten agrupar sensores que probablemente proporcionen tipos de información similares o que estén relacionados de alguna manera. Cada categoría se representa mediante una constante GUID . Por ejemplo, los sensores que notifican coordenadas de latitud y longitud pertenecen a la categoría del sensor de ubicación. Esto se representa mediante la constante SENSOR_CATEGORY_LOCATION.
• Los tipos de sensor representan tipos específicos de sensores. Cada tipo de sensor se ajusta a una categoría determinada. Dos sensores de tipos diferentes pueden pertenecer a la misma categoría o a categorías diferentes. Cada tipo de sensor se representa mediante una constante GUID . Por ejemplo, un sensor del sistema de posicionamiento global se identificaría mediante la constante SENSOR_TYPE_LOCATION_GPS. Sin embargo, un sensor que proporciona la ubicación actual mediante una dirección IP se identificaría mediante la constante SENSOR_TYPE_LOCATION_LOOKUP. Sin embargo, ambos sensores pertenecerían a la categoría del sensor de ubicación.
• Los tipos de datos representan tipos específicos de información que el sensor puede proporcionar. Los tipos de datos del sensor pueden contener el valor real de medición, como la altitud; información sobre las unidades usadas para expresar los datos, como medidores; y puntos de referencia para los datos, como el nivel del mar. Cada tipo de datos se representa mediante una constante PROPERTYKEY . Por ejemplo, el tipo de datos que representa la altitud sobre el nivel del mar, en metros, se identificaría mediante la constante SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Cuando se notifican datos, se dice que un valor se incluye en un campo de datos y una colección de campos de datos relacionados componen un informe de datos. Los informes de datos se empaquetan juntos mediante la interfaz IPortableDeviceValues . Cada informe de datos debe contener al menos un campo de datos válido y una marca de tiempo que identifique cuándo se creó el informe de datos. Las marcas de tiempo se representan mediante la constante SENSOR_DATA_TYPE_TIMESTAMP.

Otras constantes

El programa también debe usar otras constantes. Estas constantes incluyen lo siguiente:

• Propiedades del sensor, como SENSOR_PROPERTY_DESCRIPTION. Normalmente, estas constantes se usan para describir un sensor. El sensor debe proporcionar algunas propiedades del sensor, algunas propiedades se pueden establecer mediante aplicaciones cliente y algunas siempre deben devolver el mismo valor del sensor. La sección Referencia de propiedades del sensor proporciona esta información para cada propiedad.
• Constantes de eventos, como SENSOR_EVENT_STATE_CHANGED. Las constantes de evento incluyen GUID, que representan tipos de eventos y PROPERTYKEY, que representan tipos de parámetros de evento. Usará estas constantes para las llamadas a métodos, como ISensor::SetEventInterest e ISensor::GetEventInterest.

Constantes personalizadas

Los fabricantes de sensores pueden definir constantes personalizadas. Por ejemplo, un sensor puede pertenecer a una categoría no definida por la plataforma. Para poder usar un sensor que defina constantes personalizadas, el fabricante del sensor debe publicar los valores, por ejemplo, publicando un archivo de encabezado. Para obtener más información, consulte la documentación que se proporciona con el sensor.