enumerazione GNSS_EVENT_TYPE (gnssdriver.h)

Questa enumerazione indica il tipo di un evento e viene utilizzata dalla struttura GNSS_EVENT.

Il driver GNSS usa eventi per inviare informazioni richieste e non richieste all'adapter GNSS. Gli eventi possono verificarsi per vari motivi, ad esempio una richiesta di driver all'adattatore GNSS per l'inserimento di dati di assistenza o per scopi informativi.

Sintassi

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;

Costanti

GNSS_Event_FixAvailable Questo evento viene generato come risultato di una precedente chiamata IOCTL_GNSS_GET_FIXDATA dall'adapter. Il driver GNSS genera questo evento quando è disponibile una correzione per la raccolta dell'adapter. I dati di correzione vengono inclusi nei dati dell'evento sotto forma di struttura GNSS_FIXDATA.
GNSS_Event_RequireAgnss Questo evento viene generato in seguito a una chiamata IOCTL_GNSS_LISTEN_AGNSS precedente dall'adattatore. Il driver genera questo evento ogni volta che richiede l'inserimento di determinati dati di assistenza AGNSS. Le specifiche dell'inserimento sono disponibili nei dati dell'evento sotto forma di struttura GNSS_AGNSS_REQUEST_PARAM.
GNSS_Event_Error Questo evento viene generato in seguito a una chiamata IOCTL_GNSS_LISTEN_ERROR precedente dall'adapter. Il driver genera questo evento quando si verifica un errore fuori banda che l'adattatore deve essere a conoscenza. I dettagli dell'errore sono disponibili nei dati dell'evento sotto forma di struttura GNSS_ERRORINFO. Le informazioni possono essere usate da Microsoft per acquisire i dati di telemetria relativi al tipo di errori rilevati nel campo da dispositivi diversi e i dati possono essere condivisi con oem/IHV per comprendere i problemi comuni e aumentare la qualità delle implementazioni del motore GNSS.
GNSS_Event_NiRequest Questo evento viene generato quando il driver vuole inviare una notifica a una richiesta ni. HLOS elaborerà la richiesta( ad esempio, visualizzerà una finestra di dialogo, se richiesto), quindi inserirà una risposta al driver.
GNSS_Event_NmeaData Questo evento viene generato come risultato di una chiamata IOCTL_GNSS_LISTEN_NMEA precedente, se la registrazione di NMEA è abilitata nel dispositivo. Il driver GNSS genera questo evento quando i dati di NMEA sono pronti per essere letti dal client chiamante. Il client chiamante sarà in genere uno strumento di test. I dati delle frasi NMEA sono inclusi nei dati dell'evento sotto forma di struttura GNSS_NMEA_DATA.
GNSS_Event_GeofenceAlertData Un recinto virtuale creato in precedenza è stato violato. Al momento della creazione del recinto virtuale, il servizio HLOS ha chiesto in modo specifico un avviso quando si verifica una tale violazione. Ad esempio, un avviso per la voce non deve essere generato se HLOS ha richiesto solo avvisi di uscita.
GNSS_Event_GeofencesTrackingStatus Il motore GNSS non è in grado di tenere traccia di uno o più recinti virtuali a causa di condizioni di segnale non valido o di altri problemi di posizionamento. Uno stato viene generato anche quando il motore GNSS è stato ripristinato da una condizione di errore precedente ed è ora in grado di tenere traccia di tutti i recinti virtuali.
GNSS_Event_DriverRequest Riservato per un'estensione futura. Il driver GNSS richiede alcune informazioni fuori banda da HLOS.
GNSS_Event_BreadcrumbAlertEvent Riservato per l'estensione futura: 0x0012-0x7FFF. Per ogni nuovo tipo di evento, sarà presente un IOCTL ben definito che descrive il processo di avvio di questo evento dall'adattatore e una struttura di dati evento ben definita che descrive i dati/comandi associati a questo evento.
GNSS_Event_FixAvailable_2 I dati di correzione inclusi nei dati dell'evento nella struttura GNSS_FIXDATA_2.
GNSS_Event_Custom Riservato per azioni personalizzate specifiche del fornitore: 0x8000-0xFFFF. Il driver GNSS genera questo evento in base alle esigenze. Il comando e i dati vengono inseriti in un BLOB opaco come parte dei dati dell'evento. Il pacchetto viene inviato all'adapter per il marshalling al componente helper GNSS.

Osservazioni

Gli eventi possono essere di vari tipi. Alcuni eventi si verificano in seguito a una richiesta precedente avviata dal driver, ad esempio avviare la richiesta di correzione. Determinati eventi vengono generati a scopo informativo. Gli eventi di assistenza vengono generati quando il driver richiede che l'adattatore inserisca dati di assistenza specifici.

Fabbisogno

Requisito	Valore
server minimo supportato	Windows Server 2022
intestazione	gnssdriver.h (include Gnssdriver.h)