GNSS_EVENT_TYPE-Enumeration (gnssdriver.h)

Diese Enumeration gibt den Typ eines Ereignisses an und wird von der GNSS_EVENT-Struktur verwendet.

Der GNSS-Treiber verwendet Ereignisse, um angeforderte und nicht angeforderte Informationen an den GNSS-Adapter zu senden. Ereignisse können aus verschiedenen Gründen auftreten, z. B. eine Treiberanforderung an den GNSS-Adapter zur Einschleusung von Unterstützungsdaten oder zu Informationszwecken.

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;

Konstanten

GNSS_Event_FixAvailable Dieses Ereignis wird als Ergebnis eines vorherigen IOCTL_GNSS_GET_FIXDATA Aufrufs des Adapters ausgelöst. Der GNSS-Treiber löst dieses Ereignis aus, wenn eine Korrektur verfügbar ist, die vom Adapter erfasst werden kann. Die Fixdaten sind in den Ereignisdaten in Form von GNSS_FIXDATA Struktur enthalten.
GNSS_Event_RequireAgnss Dieses Ereignis wird als Ergebnis eines vorherigen IOCTL_GNSS_LISTEN_AGNSS Aufrufs des Adapters ausgelöst. Der Treiber löst dieses Ereignis aus, wenn er bestimmte AGNSS-Unterstützungsdaten einschleusen muss. Die Besonderheiten der Injektion sind in den Ereignisdaten in Form von GNSS_AGNSS_REQUEST_PARAM Struktur verfügbar.
GNSS_Event_Error Dieses Ereignis wird als Ergebnis eines vorherigen IOCTL_GNSS_LISTEN_ERROR Aufrufs des Adapters ausgelöst. Der Treiber löst dieses Ereignis aus, wenn ein Out-of-Band-Fehler auftritt, den der Adapter beachten muss. Die Fehlerdetails sind in den Ereignisdaten in Form von GNSS_ERRORINFO Struktur verfügbar. Die Informationen können von Microsoft verwendet werden, um Telemetriedaten darüber zu erfassen, welche Art von Fehlern im Feld von verschiedenen Geräten erkannt werden, und die Daten könnten für OEMs/IHVs freigegeben werden, um häufige Probleme zu verstehen und die Qualität von GNSS-Engine-Implementierungen zu verbessern.
GNSS_Event_NiRequest Dieses Ereignis wird ausgelöst, wenn der Treiber eine NI-Anforderung benachrichtigen möchte. Der HLOS verarbeitet die Anforderung (zeigt z. B. bei Bedarf ein Dialogfeld an), und fügt dann eine Antwort an den Treiber zurück.
GNSS_Event_NmeaData Dieses Ereignis wird als Ergebnis eines vorherigen aufrufs IOCTL_GNSS_LISTEN_NMEA ausgelöst, wenn die NMEA-Protokollierung auf dem Gerät aktiviert ist. Der GNSS-Treiber löst dieses Ereignis aus, wenn NMEA-Daten vom aufrufenden Client gelesen werden können. Der aufrufende Client ist in der Regel ein Testtool. Die Daten der NMEA-Sätze sind in den Ereignisdaten in Form einer GNSS_NMEA_DATA-Struktur enthalten.
GNSS_Event_GeofenceAlertData Ein zuvor erstellter Geofence wurde verletzt. Zum Zeitpunkt der Geofence-Erstellung hatte der HLOS ausdrücklich um eine Warnung gebeten, wenn eine solche Verletzung auftritt. Beispielsweise sollte keine Warnung für den Eintrag ausgelöst werden, wenn der HLOS nur Exitwarnungen angefordert hat.
GNSS_Event_GeofencesTrackingStatus Die GNSS-Engine kann einen oder mehrere Geofences aufgrund von schlechten Signalbedingungen oder anderen Positionierungsproblemen nicht nachverfolgen. Ein status wird auch ausgelöst, wenn die GNSS-Engine nach einer früheren Fehlerbedingung wiederhergestellt wurde und nun alle Geofences nachverfolgen kann.
GNSS_Event_DriverRequest Reserviert für zukünftige Erweiterungen. Der GNSS-Treiber fordert einige Out-of-Band-Informationen vom HLOS an.
GNSS_Event_BreadcrumbAlertEvent Reserviert für zukünftige Erweiterung: 0x0012-0x7FFF. Für jeden neuen Ereignistyp gibt es eine klar definierte IOCTL, die den Initiierungsprozess dieses Ereignisses durch den Adapter beschreibt, und eine klar definierte Ereignisdatenstruktur, die die Daten bzw. den Befehl beschreibt, die diesem Ereignis zugeordnet sind.
GNSS_Event_FixAvailable_2 Die Fixdaten, die in den Ereignisdaten in der GNSS_FIXDATA_2-Struktur enthalten sind.
GNSS_Event_Custom Reserviert für anbieterspezifische benutzerdefinierte Aktionen: 0x8000-0xFFFF. Der GNSS-Treiber löst dieses Ereignis nach Bedarf aus. Der Befehl und die Daten werden in einem undurchsichtigen Blob als Teil der Ereignisdaten verpackt. Das Paket wird zum Marshallen an die GNSS-Hilfskomponente an den Adapter gesendet.

Hinweise

Ereignisse können von verschiedenen Typen sein. Bestimmte Ereignisse treten als Folge einer vorherigen Anforderung auf, die vom Treiber initiiert wurde, z. B. starte die Fixanforderung. Bestimmte Ereignisse werden zu Informationszwecken ausgelöst. Unterstützungsereignisse werden ausgelöst, wenn der Treiber vom Adapter verlangt, dass bestimmte Unterstützungsdaten eingefügt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Server)	Windows Server 2022
Kopfzeile	gnssdriver.h (include Gnssdriver.h)