Поделиться через

Сведения о константах датчика

  • Статья

Платформа датчика и расположения Windows использует константы различными способами. Платформа определяет различные константы, которые можно использовать в коде драйвера датчика. Производители датчиков могут определять пользовательские константы. Определения констант, определяемых платформой, можно найти в файле Sensors.h. Подробные сведения о константах датчика, определяемых платформой, см. в разделе Константы.

Организация датчиков и данных

Платформа упорядочивает датчики и данные следующими способами.

  • Категории представляют широкие классы устройств датчиков. Категории позволяют группировать датчики, которые, скорее всего, будут предоставлять аналогичные типы информации или каким-либо образом связаны друг с другом. Каждая категория представлена константой GUID . Например, датчики, сообщающие координаты широты и долготы, относятся к категории датчиков местоположения. Он представлен константой SENSOR_CATEGORY_LOCATION.
  • Типы датчиков представляют определенные типы датчиков. Каждый тип датчика относится к определенной категории. Два датчика разных типов могут относиться к одной или разным категориям. Каждый тип датчика представлен константой GUID . Например, датчик системы глобального позиционирования идентифицируется константой SENSOR_TYPE_LOCATION_GPS. Однако датчик, предоставляющий текущее расположение с помощью IP-адреса, будет определяться константой SENSOR_TYPE_LOCATION_LOOKUP. Однако оба датчика будут относиться к категории датчиков расположения.
  • Типы данных представляют определенные виды информации, которую может предоставить датчик. Типы данных датчиков могут содержать фактическое значение измерения, например высоту; сведения о единицах, используемых для выражения данных, таких как метры; и опорных точек для данных, таких как уровень моря. Каждый тип данных представлен константой PROPERTYKEY . Например, тип данных, представляющий высоту над уровнем моря в метрах, будет определяться константой SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
  • При отправке данных считается, что значение содержится в поле данных, а коллекция связанных полей данных составляет отчет о данных. Отчеты о данных упаковываются с помощью интерфейса IPortableDeviceValues . Каждый отчет о данных должен содержать по крайней мере одно допустимое поле данных и метку времени, которая определяет время создания отчета по данным. Метки времени представлены константой SENSOR_DATA_TYPE_TIMESTAMP.

Другие константы

Программа также должна использовать другие константы. К этим константам относятся следующие:

  • Свойства датчика, например SENSOR_PROPERTY_DESCRIPTION. Обычно эти константы используются для описания датчика. Некоторые свойства датчика должны быть предоставлены датчиком, некоторые свойства могут быть заданы клиентскими приложениями, а некоторые всегда должны возвращать одно и то же значение от датчика. В разделе Справочник по свойствам датчика приведены эти сведения для каждого свойства.
  • Константы событий, такие как SENSOR_EVENT_STATE_CHANGED. Константы событий включают идентификаторы GUID, представляющие типы событий, и PROPERTYKEY, представляющие типы параметров событий. Эти константы будут использоваться для вызовов методов, таких как ISensor::SetEventInterest и ISensor::GetEventInterest.

Настраиваемые константы

Производители датчиков могут определять пользовательские константы. Например, датчик может относиться к категории, не определенной платформой. Прежде чем использовать датчик, определяющий пользовательские константы, производитель датчика должен опубликовать значения, например путем публикации файла заголовка. Дополнительные сведения см. в документации, которая предоставляется вместе с датчиком.