enumeração GNSS_EVENT_TYPE (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. Os 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.

Syntax

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 anterior IOCTL_GNSS_GET_FIXDATA 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 em forma de estrutura de GNSS_FIXDATA .
GNSS_Event_RequireAgnss Esse evento é gerado como resultado de uma chamada anterior IOCTL_GNSS_LISTEN_AGNSS 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 na forma de GNSS_AGNSS_REQUEST_PARAM estrutura.
GNSS_Event_Error Esse evento é gerado como resultado de uma chamada anterior IOCTL_GNSS_LISTEN_ERROR do adaptador. O driver gera esse evento quando ocorre um erro fora de banda do qual 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 ni. O HLOS processará a solicitação (por exemplo, exibirá uma caixa de diálogo se solicitado) e injetará uma resposta de volta no driver.
GNSS_Event_NmeaData Esse evento é gerado como resultado de uma chamada de 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 pediu especificamente um alerta quando tal violação acontece. Por exemplo, um alerta para 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 incorretas 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 extensão futura. O driver GNSS está solicitando algumas informações fora de banda do HLOS.
GNSS_Event_BreadcrumbAlertEvent Reservado para extensão futura: 0x0012-0x7FFF. Para cada novo tipo de evento, haverá um IOCTL bem definido que descreve 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.

Comentários

Os eventos podem ser de vários tipos. Determinados eventos ocorrem como resultado de uma solicitação anterior iniciada pelo driver, por exemplo, iniciar 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 injete dados de assistência específicos.

Requisitos

Requisito	Valor
Servidor mínimo com suporte	Windows Server 2022
Cabeçalho	gnssdriver.h (inclua Gnssdriver.h)