IOCTL_GNSS_LISTEN_NMEA IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_LISTEN_NMEA-Steuerelementcode wird verwendet, um mit der Überwachung auf NMEA-Ereignisse vom Treiber zu beginnen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Auf NULL festgelegt.

Länge des Eingabepuffers

Auf 0 festlegen.

Ausgabepuffer

Ein Zeiger auf eine GNSS_EVENT-Struktur .

Länge des Ausgabepuffers

Auf sizeof(GNSS_EVENT) festgelegt.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Der EventType muss auf GNSS_Event_NmeaData festgelegt werden.

Hinweise zum GNSS-Adapter

Der GNSS-Adapter verwendet diese IOCTL nicht.

Hinweise zu GNSS-Treibern

Der Treiber kann diesen Aufruf abschließen, wenn er über NMEA-Daten verfügt, die an den aufrufenden Client gesendet werden sollen. Bei diesem aufrufenden Client handelt es sich in der Regel um ein Testtool, das vom OEM erstellt wurde.

Der aufrufende Client, der NMEA-Daten empfangen möchte, muss die folgenden Aufgaben ausführen:

Stellen Sie sicher, dass die NMEA-Protokollierung aktiv ist.
Stellt sicher, dass diese Anforderung immer aussteht, sodass der Treiber NMEA-Daten zurückgeben kann, sofern verfügbar.

Wenn der Treiber den E/A-Aufruf abschließt, muss der aufrufende Client eine weitere IOCTL ausgeben, um weiterhin auf weitere NMEA-Daten zu warten.