IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_DELETE_GEOFENCE-Steuerelementcode wird vom GNSS-Adapter verwendet, um einen zuvor erstellten Geofence zu löschen.

Gilt für GNSS DDI Version 2 und höher.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Zeiger auf eine GNSS_GEOFENCE_DELETE_PARAM-Struktur , die den zu löschenden Geofence definiert.

Eingabepufferlänge

Legen Sie auf sizeof(GNSS_GEOFENCE_DELETE_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

NTSTATUS mit den folgenden Hinweisen:

STATUS_SUCCESS: Der Treiber hat den Geofence erfolgreich entfernt.
STATUS_UNSUCCESSFUL: Fehler, der Geofence kann nicht gelöscht werden.

Hinweise zu GNSS-Adaptern

Der GNSS-Adapter erwartet nicht, dass dieser Aufruf fehlschlägt, da es keine elegante Möglichkeit gibt, die Folgen dieses Fehlers zu behandeln. Bei Einem Fehler gibt der GNSS-Adapter den Befehl GNSS_ResetGeofencesTracking aus und fügt die Geofences erneut hinzu.

Hinweise zu GNSS-Treibern

Wenn dies der letzte Geofence ist, sollte der GNSS-Treiber die Geofencenachverfolgung beenden. Wenn die GNSS-Engine vor dem Löschen des letzten Geofences nicht in der Lage war, Geofences (aufgrund schlechter Signalbedingungen oder anderer vorübergehender Fehler) nachzuverfolgen, sollte die Überwachungsaktivität beendet werden.

Wenn der Geofence erfolgreich entfernt wurde, gibt der Treiber STATUS_SUCCESS zurück. Wenn der Geofence nicht gelöscht werden kann, wird ein Fehlercode (STATUS_UNSUCCESSFUL) zurückgegeben. Wenn ein Fehler auftritt, gibt der GNSS-Adapter den Befehl GNSS_ResetGeofencesTracking aus und erstellt die gewünschten Geofences neu. Wenn dieser Befehl den zuletzt definierten Geofence löscht, beendet der Treiber die Geofencenachverfolgung.