GNSS_EVENT_TYPE enumeração (gnssdriver.h)

Essa enumeração indica o tipo de um evento e é usada pela estrutura GNSS_EVENT.

O driver GNSS utiliza eventos para enviar informações solicitadas e não solicitadas ao adaptador GNSS. Eventos podem ocorrer por vários motivos, como uma solicitação de driver para o adaptador GNSS para a injeção de dados de assistência ou para fins informativos.

Sintaxe

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;

Constantes

 
GNSS_Event_FixAvailable
Esse evento é gerado como resultado de uma chamada IOCTL_GNSS_GET_FIXDATA anterior do adaptador. O driver GNSS gera esse evento quando uma correção está disponível para o adaptador coletar. Os dados de correção são incluídos nos dados de evento na forma de GNSS_FIXDATA estrutura.
GNSS_Event_RequireAgnss
Esse evento é gerado como resultado de uma chamada IOCTL_GNSS_LISTEN_AGNSS anterior do adaptador. O driver gera esse evento sempre que precisa de injeção de determinados dados de assistência do AGNSS. As especificidades da injeção estão disponíveis nos dados do evento em forma de estrutura de GNSS_AGNSS_REQUEST_PARAM.
GNSS_Event_Error
Esse evento é gerado como resultado de uma chamada IOCTL_GNSS_LISTEN_ERROR anterior do adaptador. O driver gera esse evento quando ocorre um erro fora de banda que o adaptador precisa estar ciente. Os detalhes do erro estão disponíveis nos dados do evento na forma de GNSS_ERRORINFO estrutura. As informações podem ser usadas pela Microsoft para capturar dados de telemetria sobre que tipo de erros são vistos no campo por diferentes dispositivos, e os dados podem ser compartilhados com OEMs/IHVs para ajudar a entender problemas comuns e aumentar a qualidade das implementações do mecanismo GNSS.
GNSS_Event_NiRequest
Esse evento é gerado quando o driver deseja notificar uma solicitação de NI. O HLOS processará a solicitação (por exemplo, exibirá uma caixa de diálogo se solicitado) e, em seguida, injetará uma resposta de volta no driver.
GNSS_Event_NmeaData
Esse evento é gerado como resultado de uma chamada IOCTL_GNSS_LISTEN_NMEA anterior, se o registro em log NMEA estiver habilitado no dispositivo. O driver GNSS gera esse evento quando os dados NMEA estão prontos para serem lidos pelo cliente de chamada. O cliente de chamada normalmente será uma ferramenta de teste. Os dados de frases NMEA são incluídos nos dados de evento em forma de estrutura de GNSS_NMEA_DATA.
GNSS_Event_GeofenceAlertData
Uma cerca geográfica criada anteriormente foi violada. No momento da criação da cerca geográfica, o HLOS havia solicitado especificamente um alerta quando tal violação acontece. Por exemplo, um alerta de entrada não deve ser gerado se o HLOS solicitou apenas alertas de saída.
GNSS_Event_GeofencesTrackingStatus
O mecanismo GNSS não consegue rastrear uma ou mais cercas geográficas devido a condições de sinal incorreto ou outros problemas de posicionamento. Um status também é gerado quando o mecanismo GNSS se recupera de uma condição de falha anterior e agora é capaz de rastrear todas as cercas geográficas.
GNSS_Event_DriverRequest
Reservado para a extensão futura.

O driver GNSS está solicitando algumas informações fora de banda do HLOS.
GNSS_Event_BreadcrumbAlertEvent
Reservado para a extensão futura: 0x0012-0x7FFF.

Para cada novo tipo de evento, haverá um IOCTL bem definido descrevendo o processo de iniciação desse evento pelo adaptador e uma estrutura de dados de evento bem definida que descreve os dados/comando associados a esse evento.
GNSS_Event_FixAvailable_2
Os dados de correção incluídos nos dados de evento na estrutura GNSS_FIXDATA_2.
GNSS_Event_Custom
Reservado para ações personalizadas específicas do fornecedor: 0x8000-0xFFFF.

O driver GNSS gera esse evento conforme necessário. O comando e os dados são empacotados em um blob opaco como parte dos dados do evento. O pacote é enviado para o adaptador para marshaling para o componente auxiliar do GNSS.

Observações

Os eventos podem ser de vários tipos. Determinados eventos ocorrem como resultado de uma solicitação anterior iniciada pelo driver, por exemplo, iniciar a solicitação de correção. Determinados eventos são gerados para fins informativos. Os eventos de assistência são gerados quando o driver exige que o adaptador insira dados de assistência específicos.

Requisitos

Requisito Valor
servidor com suporte mínimo Windows Server 2022
cabeçalho gnssdriver.h (inclua Gnssdriver.h)
  • Last updated on