IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_MODIFY_FIXSESSION-Steuerelementcode wird vom GNSS-Adapter verwendet, um die Korrektursitzungsparameter einer aktiven Fixsitzung zu ändern. Dies ist nur erforderlich, wenn der GNSS-Treiber mehrere Fixsitzungen desselben Fixtyps nicht unterstützt, z. B. wenn die SupportMultipleFixSession-Funktion des Treibers FALSE ist.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine GNSS_FIXSESSION_PARAM-Struktur .

Eingabepufferlänge

Legen Sie auf sizeof(GNSS_FIXSESSION_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 geändert.
Die Fixsitzung ist derzeit beendet oder nicht aktiv.
Der Fixsitzungsparameter konnte nicht geändert werden.

Hinweise zu GNSS-Adaptern

Der GNSS-Adapter verwendet diese IOCTL, um die Fixsitzungsparameter einer aktiven Fixsitzung zu ändern, um neue Fixanforderungen von LBS-Anwendungen zu erfüllen.

Wenn der Aufruf fehlschlägt, multiplext der GNSS-Adapter die neue Fixanforderung nicht in die vorhandene aktive Sitzung ein. Stattdessen wird weiterhin davon ausgegangen, dass die aktive Fixsitzung unverändert geblieben ist.

Wenn der Aufruf erfolgreich ist, erwartet der GNSS-Adapter, dass die nachfolgenden Fixdaten den neu angegebenen Sitzungsparametern entsprechen.

Hinweise zu GNSS-Treibern

Wenn keine Unterstützung für mehrere Sitzungen vorhanden ist, muss der GNSS-Treiber diese IOCTL unterstützen und die Fixsitzungsparameter für die aktive Sitzung im Flug ändern.

Sobald der GNSS-Treiber die Fixsitzungsparameter akzeptiert, überprüft und an die GNSS-Engine sendet, sollte er die E/A-Anforderung sofort mit einem erfolgreichen Rückgabecode abschließen.

Nach erfolgreichem Abschluss sollte der GNSS-Treiber alle Fixdaten gemäß den neuen Fixsitzungsparametern zurückgeben. Korrekturdaten, die bereits für den GNSS-Adapter bereitgestellt werden, sollten jedoch weiterhin verfügbar gemacht werden und sollten nicht verworfen werden.