IOCTL_GNSS_SEND_DRIVERCOMMAND IOCTL (gnssdriver.h)

Artikel
02/26/2024

Der IOCTL_GNSS_SEND_DRIVERCOMMAND-Steuerungscode wird vom GNSS-Adapter verwendet, um klar definierte Befehle auf dem Treiber auszuführen und auch Treiberkonfigurationsparameter festzulegen. Jeder Aufruf gibt einen bestimmten Befehlstyp und die zugeordneten Daten für den Befehl (sofern zutreffend) über die GNSS_DRIVERCOMMAND_PARAM-Struktur an.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine GNSS_DRIVERCOMMAND_PARAM-Struktur .

Länge des Eingabepuffers

Auf sizeof(GNSS_DRIVERCOMMAND_PARAM) festgelegt.

Ausgabepuffer

Auf NULL festgelegt.

Länge des Ausgabepuffers

Auf 0 festlegen.

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 Treiber legt einen der folgenden NTSTATUS-Werte fest, um das Ergebnis anzugeben.

STATUS_SUCCESS
Befehl nicht unterstützt
Befehl nicht ausgeführt
Befehl verzögert
Fehler beim Befehl

Hinweise zum GNSS-Adapter

Mit Ausnahme einiger Befehle ignoriert der GNSS-Adapter im Allgemeinen alle Fehler, die bei der Ausführung eines bestimmten Befehls auftreten.

Hinweise zu GNSS-Treibern

Wenn der GNSS-Treiber einen bestimmten Befehl nicht unterstützt, wird dies angegeben. Treiber müssen nicht alle befehle unterstützen, die in diesem Protokoll definiert sind. Der Treiber sollte die E/A-Vorgänge erst nach Abschluss der Ausführung des Befehls abschließen.