IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

Artículo
02/07/2025

El adaptador de GNSS usa el código de control IOCTL_GNSS_DELETE_GEOFENCE para eliminar una geovalla creada anteriormente.

Se aplica a la versión 2 y posteriores de DDI de GNSS.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Puntero a una estructura GNSS_GEOFENCE_DELETE_PARAM que define la geovalla que se va a eliminar.

Longitud del búfer de entrada

Establezca en sizeof(GNSS_GEOFENCE_DELETE_PARAM).

Búfer de salida

Establezca en null.

Longitud del búfer de salida

Establezca en 0.

Bloque de estado

Irp->ioStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, estado a la condición de error adecuada como código NTSTATUS.

Observaciones

NTSTATUS con las siguientes indicaciones:

STATUS_SUCCESS: el controlador quitó correctamente la geovalla.
STATUS_UNSUCCESSFUL: No se pudo eliminar la geovalla.

Notas del adaptador de GNSS

El adaptador GNSS no espera que se produzca un error en esta llamada porque no hay ninguna manera elegante de controlar la consecuencia de este error. Si se produce un error, el adaptador de GNSS emitirá el comando GNSS_ResetGeofencesTracking y volverá a agregar las geovallas.

Notas del controlador GNSS

Si esta es la última geovalla, el controlador GNSS debe detener el seguimiento de geovalla. Si el motor GNSS no pudo realizar un seguimiento de las geovallas (debido a condiciones de señal incorrectas u otros errores transitorios) antes de la eliminación de la última geovalla, la actividad de supervisión debe detenerse.

Si la geovalla se quita correctamente, el controlador devuelve STATUS_SUCCESS. Si no se puede eliminar la geovalla, se devuelve un código de error, STATUS_UNSUCCESSFUL. Si se produce un error, el adaptador de GNSS emite el comando GNSS_ResetGeofencesTracking y vuelve a crear las geovallas deseadas. Si este comando elimina la última geovalla definida, el controlador detiene el seguimiento de geovalla.