IOCTL_GNSS_SEND_PLATFORM_CAPABILITY IOCTL (gnssdriver.h)

Artikel
02/07/2025

Der IOCTL_GNSS_SEND_PLATFORM_CAPABILITY Steuercode wird vom GNSS-Adapter verwendet, um die verschiedenen standortspezifischen Plattformfunktionen zu kommunizieren. Der GNSS-Treiber kann diese Daten auf verschiedene Weise verwenden. Wenn die Plattform z. B. keine Unterstützungsdaten unterstützt, kann der GNSS-Treiber das Mobilfunknetz verwenden, um solche Informationen zu suchen. Die Verwendung der einzelnen Funktionsinformationen ist optional, und der Treiber kann die Plattformfunktionsinformationen für den Betrieb ignorieren.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine GNSS_PLATFORM_CAPABILITY Struktur.

Eingabepufferlänge

Auf sizeof(GNSS_PLATFORM_CAPABILITY) festgelegt.

Ausgabepuffer

Auf NULL festgelegt.

Länge des Ausgabepuffers

Auf 0 festgelegt.

Statusblock

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

Bemerkungen

Der Treiber legt einen der folgenden NTSTATUS-Werte fest, um das Ergebnis anzugeben.

STATUS_SUCCESS, wenn der Treiber die Funktionsinformationen erfolgreich verarbeitet.
Fehlgeschlagene, wenn der Treiber die Funktionsinformationen nicht erfolgreich verarbeitet.
Ignoriert, wenn der Treiber die Funktionsinformationen ignoriert.

GNSS-Adapternotizen

Dies ist ein leerer Fire-and-Forget-Stilaufruf an den Treiber. Der GNSS-Adapter führt auch dann keine spezielle Fehlerbehandlung durch, wenn der Aufruf fehlschlägt.

GNSS-Treibernotizen

Der Treiber kann die Funktionsinformationen in Zustandsvariablen aufzeichnen und nach Bedarf an das Modul übergeben. Die E/A sollte abgeschlossen werden, sobald die Konfigurationsinformationen kopiert werden.

Dies sollte aufgerufen werden, wenn der GNSS-Adapter den GNSS-Treiber initialisiert.