Acerca de las constantes del sensor

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.

Organización de sensores y datos

La plataforma organiza sensores y datos de las siguientes maneras.

• 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 lo representa la constante SENSOR_CATEGORY_LOCATION.
• Los tipos de sensor representan tipos específicos de sensores. Cada tipo de sensor encaja en 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 de 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 de medida real, como la altitud; información sobre las unidades utilizadas para expresar los datos, como los 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 constituyen 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. En la sección referencia propiedades del sensor se proporciona esta información para cada propiedad.
• Constantes de evento, como SENSOR_EVENT_STATE_CHANGED. Las constantes de evento incluyen GUID, que representan tipos de eventos y PROPERTYKEYs, que representan tipos de parámetros de evento. Usará estas constantes para las llamadas de método, 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.