IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

Artículo
03/05/2024

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 de 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

Se establece en NULL.

Longitud del búfer de salida

Establecer en 0.

Bloque de estado

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

Comentarios

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 de 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.