Sobre constantes de sensor

A plataforma Sensor e Localização do Windows usa constantes de várias maneiras. A plataforma define diferentes constantes que você pode usar no código do driver do sensor. Os fabricantes de sensores podem definir constantes personalizadas. Você pode encontrar as definições de constantes definidas pela plataforma no arquivo Sensors.h. Para obter informações detalhadas sobre constantes de sensor definidas pela plataforma, consulte Constantes.

Organização de dados e sensor

A plataforma organiza sensores e dados das seguintes maneiras.

• As categorias representam classes amplas de dispositivos de sensor. As categorias permitem agrupar sensores que provavelmente fornecerão tipos semelhantes de informações ou estão relacionados de alguma forma. Cada categoria é representada por uma constante GUID . Por exemplo, os sensores que relatam coordenadas de latitude e longitude pertencem à categoria do sensor de localização. Isso é representado pela constante SENSOR_CATEGORY_LOCATION.
• Os tipos de sensor representam tipos específicos de sensores. Cada tipo de sensor se encaixa em uma categoria específica. Dois sensores de tipos diferentes podem pertencer à mesma categoria ou categorias diferentes. Cada tipo de sensor é representado por uma constante GUID . Por exemplo, um sensor do sistema de posicionamento global seria identificado pela constante SENSOR_TYPE_LOCATION_GPS. No entanto, um sensor que fornece o local atual usando um endereço IP seria identificado pela constante SENSOR_TYPE_LOCATION_LOOKUP. No entanto, ambos os sensores pertenceriam à categoria do sensor de localização.
• Os tipos de dados representam tipos específicos de informações que o sensor pode fornecer. Os tipos de dados do sensor podem conter o valor de medida real, como altitude; informações sobre as unidades usadas para expressar os dados, como medidores; e pontos de referência para os dados, como o nível do mar. Cada tipo de dados é representado por uma constante PROPERTYKEY . Por exemplo, o tipo de dados que representa a altitude acima do nível do mar, em metros, seria identificado pela constante SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Ao relatar dados, um valor é dito estar contido em um campo de dados e uma coleção de campos de dados relacionados compõem um relatório de dados. Os relatórios de dados são empacotados juntos usando a interface IPortableDeviceValues . Cada relatório de dados deve conter pelo menos um campo de dados válido e um carimbo de data/hora que identifique quando o relatório de dados foi criado. Os carimbos de data/hora são representados pela constante SENSOR_DATA_TYPE_TIMESTAMP.

Outras constantes

Seu programa também deve usar outras constantes. Essas constantes incluem o seguinte:

• Propriedades do sensor, como SENSOR_PROPERTY_DESCRIPTION. Normalmente, essas constantes são usadas para descrever um sensor. Algumas propriedades do sensor devem ser fornecidas pelo sensor, algumas propriedades podem ser definidas por aplicativos cliente e algumas sempre devem retornar o mesmo valor do sensor. A seção de referência Propriedades do Sensor fornece essas informações para cada propriedade.
• Constantes de evento, como SENSOR_EVENT_STATE_CHANGED. As constantes de evento incluem GUIDs, que representam tipos de eventos e PROPERTYKEYs, que representam tipos de parâmetro de evento. Você usará essas constantes para chamadas de método, como ISensor::SetEventInterest e ISensor::GetEventInterest.

Constantes personalizadas

Os fabricantes de sensores podem definir constantes personalizadas. Por exemplo, um sensor pode pertencer a uma categoria não definida pela plataforma. Antes de usar um sensor que define constantes personalizadas, o fabricante do sensor deve publicar os valores, por exemplo, publicando um arquivo de cabeçalho. Para obter mais informações, consulte a documentação fornecida com o sensor.