IOCTL_GNSS_LISTEN_AGNSS IOCTL (gnssdriver.h)

  • Artikel

Der IOCTL_GNSS_LISTEN_AGNSS-Steuerungscode wird vom GNSS-Adapter verwendet, um das Lauschen auf AGNSS-Anforderungen zu starten, die vom GNSS-Treiber ausgegeben werden. Diese IOCTL stellt dem GNSS-Treiber effektiv eine ausstehende E/A-Anforderung zur Verfügung, deren asynchrone Auflösung den Adapter über das überlappende GNSSEvent-Element benachrichtigt, dass der Treiber eine AGNSS-Einschleusung erfordert. Das GNSSEvent-Element ist eine GNSS_EVENT-Struktur . Der GNSS-Adapter stellt sicher, dass diese Anforderung immer aussteht, und stellt eine neue Anforderung aus, sobald die ausstehende Anforderung aufgelöst wird. Wenn die E/A-Anforderung aufgelöst ist, gibt der GNSS-Adapter eine entsprechende IOCTL_GNSS_INJECT_AGNSS mit den entsprechenden Einschleusungsdaten aus.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Auf NULL festgelegt.

Eingabepufferlänge

Auf 0 festlegen.

Ausgabepuffer

Auf NULL festgelegt.

Länge des Ausgabepuffers

Auf 0 festlegen.

Statusblock

Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Ausgabe

GNSS_EVENT

Der EventType muss auf GNSS_Event_RequireAGNSS festgelegt werden, und der AGNSSRequest-Member muss ausgefüllt werden.

Hinweise zu GNSS-Adaptern

Der GNSS-Adapter stellt sicher, dass diese Anforderung immer aussteht, sodass der Treiber angeben kann, dass eine AGNSS-Einschleusung erforderlich ist.

Wenn der Treiber den E/A-Aufruf abschließt, gibt der Adapter eine weitere IOCTL aus, um weiterhin auf weitere AGNSS-Anforderungen zu warten.

Abhängig vom AGNSSRequest.RequestType-Element gibt der Treiber IOCTL_GNSS_INJECT_AGNSS mit den entsprechenden Einschleusungsdaten aus.

Hinweise zu GNSS-Treibern

Wenn der GNSS-Treiber Unterstützungsdaten benötigt, schließt er den E/A-Vorgang ab, um Einschleusungsdaten vom Adapter zu suchen.

Anforderungen

Anforderung Wert
Header GNSSDRIVER.h

Weitere Informationen

Erstellen von IOCTL-Anforderungen in Treibern

WdfIoTargetSendInternalIoctlOthersSynchronly

WdfIoTargetSendInternalIoctlSynchronly

WdfIoTargetSendIoctlSynchronly