IOCTL_GNSS_STOP_FIXSESSION IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_STOP_FIXSESSION-Steuerelementcode wird vom GNSS-Adapter verwendet, um eine aktive Fixsitzung zu beenden.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine GNSS_STOPFIXSESSION_PARAM-Struktur .

Eingabepufferlänge

Legen Sie auf sizeof(GNSS_STOPFIXSESSION_PARAM) fest.

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

Der Treiber legt einen NTSTATUS-Wert fest, um eines der folgenden Ergebnisse anzugeben.

Die Fixsitzung wurde erfolgreich beendet.
Die Fixsitzung wurde bereits beendet oder ist nicht aktiv.

Hinweise zu GNSS-Adaptern

Der GNSS-Adapter gibt für jeden erfolgreichen Startfix immer einen Stoppfix aus. Wenn keine Unterstützung für mehrere Sitzungen vorhanden ist, beendet der GNSS-Adapter jede aktive Fixsitzung desselben Typs, bevor eine neue Startfixanforderung ausgegeben wird.

Hinweise zu GNSS-Treibern

Der GNSS-Treiber muss alle ausstehenden Fixanforderungen abbrechen/beenden und dann die E/A-Vorgänge abschließen, damit der Adapter keine Fixdaten zur beendeten Sitzung empfängt, wenn dieser Aufruf zurückgibt.

Wenn keine anderen Fixsitzungen aktiv sind, sollte der GNSS-Treiber die GNSS-Engine in einem kalten Zustand halten.