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

перечисление GNSS_EVENT_TYPE (gnssdriver.h)

  • Статья

Это перечисление указывает тип события и используется структурой GNSS_EVENT .

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

Синтаксис

typedef enum {
  GNSS_Event_FixAvailable,
  GNSS_Event_RequireAgnss,
  GNSS_Event_Error,
  GNSS_Event_NiRequest,
  GNSS_Event_NmeaData,
  GNSS_Event_GeofenceAlertData,
  GNSS_Event_GeofencesTrackingStatus,
  GNSS_Event_DriverRequest,
  GNSS_Event_BreadcrumbAlertEvent,
  GNSS_Event_FixAvailable_2,
  GNSS_Event_Custom
} GNSS_EVENT_TYPE;

Константы

 
GNSS_Event_FixAvailable
Это событие возникает в результате предварительного вызова IOCTL_GNSS_GET_FIXDATA из адаптера. Драйвер GNSS вызывает это событие, когда адаптеру доступно исправление. Данные исправления включаются в данные событий в виде структуры GNSS_FIXDATA .
GNSS_Event_RequireAgnss
Это событие возникает в результате предварительного вызова IOCTL_GNSS_LISTEN_AGNSS адаптера. Драйвер вызывает это событие всякий раз, когда ему требуется внедрение определенных данных помощи AGNSS. Особенности внедрения доступны в данных события в виде структуры GNSS_AGNSS_REQUEST_PARAM .
GNSS_Event_Error
Это событие возникает в результате предварительного вызова IOCTL_GNSS_LISTEN_ERROR из адаптера. Драйвер вызывает это событие, когда возникает внеполосная ошибка, о чем адаптер должен знать. Сведения об ошибке доступны в данных события в виде GNSS_ERRORINFO структуры. Эта информация может использоваться корпорацией Майкрософт для сбора данных телеметрии о том, какие типы ошибок отображаются на полях различными устройствами, и данные могут быть переданы изготовителям оборудования или IHV, чтобы помочь понять распространенные проблемы и повысить качество реализаций подсистемы GNSS.
GNSS_Event_NiRequest
Это событие возникает, когда драйвер хочет уведомить о запросе NI. HLOS обработает запрос (например, отобразит диалоговое окно при запросе), а затем влотит ответ обратно в драйвер.
GNSS_Event_NmeaData
Это событие возникает в результате предыдущего вызова IOCTL_GNSS_LISTEN_NMEA , если на устройстве включено ведение журнала NMEA. Драйвер GNSS вызывает это событие, когда данные NMEA готовы к чтению вызывающим клиентом. Вызывающий клиент обычно является средством тестирования. Данные предложений NMEA включаются в данные о событиях в виде структуры GNSS_NMEA_DATA .
GNSS_Event_GeofenceAlertData
Ранее созданная геозона была нарушена. Во время создания геозоны HLOS специально запросил оповещение, когда происходит такое нарушение. Например, оповещение о входе не должно создаваться, если HLOS запрашивает только оповещения о выходе.
GNSS_Event_GeofencesTrackingStatus
Подсистема GNSS не может отслеживать одну или несколько геозон из-за плохих условий сигнала или других проблем с позиционированием. Состояние также возникает, когда подсистема GNSS восстанавливается после предыдущего состояния сбоя и теперь может отслеживать все геозоны.
GNSS_Event_DriverRequest
Зарезервировано для будущего расширения.

Драйвер GNSS запрашивает некоторые внеполосные сведения из HLOS.
GNSS_Event_BreadcrumbAlertEvent
Зарезервировано для будущего расширения: 0x0012-0x7FFF.

Для каждого нового типа события будет иметься четко определенный IOCTL, описывающий процесс запуска этого события адаптером, и четко определенную структуру данных события, описывающую данные или команды, связанные с этим событием.
GNSS_Event_FixAvailable_2
Данные исправления, включенные в данные событий в структуре GNSS_FIXDATA_2 .
GNSS_Event_Custom
Зарезервировано для пользовательских действий поставщика: 0x8000 0xFFFF.

Драйвер GNSS вызывает это событие по мере необходимости. Команда и данные упаковываются в непрозрачный BLOB-объект как часть данных события. Пакет отправляется адаптеру для маршалинга во вспомогательный компонент GNSS.

Комментарии

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

Требования

Требование Значение
Минимальная версия сервера Windows Server 2022
Верхняя часть gnssdriver.h (включая Gnssdriver.h)