IOCTL_GNSS_LISTEN_DRIVER_REQUEST IOCTL (gnssdriver.h)

Artikel
03/05/2024

Der IOCTL_GNSS_LISTEN_DRIVER_REQUEST Steuercode wird vom GNSS-Treiber verwendet, um Daten aus dem HLOS abzurufen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Auf NULL festgelegt.

Länge des Eingabepuffers

Auf 0 festlegen.

Ausgabepuffer

Ein Zeiger auf eine GNSS_EVENT-Struktur .

Der EventType muss auf GNSS_Event_DriverRequest und das DriverRequestedData-Element ausgefüllt werden.

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

Hinweise zum GNSS-Adapter

Der GNSS-Adapter behält ständig eine ausstehende Anforderung bei.

Wenn der Treiber den E/A-Aufruf abschließt, gibt der Adapter eine weitere IOCTL aus, um die nächste Treiberanforderung zu erhalten.

Hinweise zu GNSS-Treibern

Es wird ständig eine ausstehende IOCTL geben. Wenn Daten von HLOS angefordert werden müssen, sollte der E/A-Vorgang abgeschlossen werden. Der GNSS-Treiber sollte die erforderlichen Daten ausfüllen, indem er die GNSS_DRIVER_REQUEST_DATA-Struktur auffüllt.

Der Treiber sollte diese IOCTL verwenden, um Daten nur in seltenen Fällen und nicht während des normalen Betriebs abzurufen. Bei einem möglichen Anwendungsfall wäre es, die SUPL-Konfiguration anzufordern, wenn die Konfiguration irgendwie verloren geht.