IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

Artigo
03/08/2023

O código de controle IOCTL_GNSS_DELETE_GEOFENCE é usado pelo adaptador GNSS para excluir uma cerca geográfica criada anteriormente.

Aplica-se ao GNSS DDI versão 2 e posterior.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um ponteiro para uma estrutura GNSS_GEOFENCE_DELETE_PARAM que define a cerca geográfica a ser excluída.

Comprimento do buffer de entrada

Defina como sizeof(GNSS_GEOFENCE_DELETE_PARAM).

Buffer de saída

Defina como NULL.

Comprimento do buffer de saída

Defina como 0.

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS .

Comentários

NTSTATUS com as seguintes indicações:

STATUS_SUCCESS: o driver removeu com êxito a cerca geográfica.
STATUS_UNSUCCESSFUL: falha, a cerca geográfica não pode ser excluída.

Notas do adaptador GNSS

O adaptador GNSS não espera que essa chamada falhe porque não há uma maneira elegante de lidar com a consequência dessa falha. Em caso de falha, o adaptador GNSS emitirá o comando GNSS_ResetGeofencesTracking e adicionará novamente as cercas geográficas.

Notas do driver GNSS

Se essa for a última cerca geográfica, o driver GNSS deverá interromper o rastreamento de cerca geográfica. Se o mecanismo de GNSS não pôde rastrear cercas geográficas (devido a condições de sinal inválido ou outros erros transitórios) antes da exclusão da última cerca geográfica, a atividade de monitoramento deverá parar.

Se a cerca geográfica for removida com êxito, o driver retornará STATUS_SUCCESS. Se a cerca geográfica não puder ser excluída, um código de falha, STATUS_UNSUCCESSFUL, será retornado. Se ocorrer uma falha, o adaptador GNSS emitirá o comando GNSS_ResetGeofencesTracking e recriará as cercas geográficas desejadas. Se esse comando excluir a última cerca geográfica definida, o driver interromperá o rastreamento de cerca geográfica.