IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

Article
03/01/2024

Le code de contrôle IOCTL_GNSS_DELETE_GEOFENCE est utilisé par l’adaptateur GNSS pour supprimer une limite géographique créée précédemment.

S’applique à GNSS DDI version 2 et ultérieure.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Pointeur vers une structure de GNSS_GEOFENCE_DELETE_PARAM qui définit la limite géographique à supprimer.

Longueur de la mémoire tampon d’entrée

Défini sur sizeof(GNSS_GEOFENCE_DELETE_PARAM).

Mémoire tampon de sortie

Défini sur NULL.

Longueur de la mémoire tampon de sortie

Définit la valeur 0.

Bloc d’état

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Sinon, indiquez la condition d’erreur appropriée en tant que code NTSTATUS .

Remarques

NTSTATUS avec les indications suivantes :

STATUS_SUCCESS : le pilote a supprimé la limite géographique.
STATUS_UNSUCCESSFUL : Échec, la limite géographique ne peut pas être supprimée.

Remarques sur l’adaptateur GNSS

L’adaptateur RTC ne s’attend pas à ce que cet appel échoue, car il n’existe aucun moyen élégant de gérer les conséquences de cette défaillance. En cas d’échec, l’adaptateur RÉINITIALISATION émet la commande GNSS_ResetGeofencesTracking et ajoute à nouveau les limites géographiques.

Remarques sur le pilote GNSS

S’il s’agit de la dernière limite géographique, le pilote GNSS doit arrêter le suivi des limites géographiques. Si le moteur GNSS n’a pas pu suivre les limites géographiques (en raison de mauvaises conditions de signal ou d’autres erreurs temporaires) avant la suppression de la dernière limite géographique, l’activité de surveillance doit s’arrêter.

Si la limite géographique est correctement supprimée, le pilote retourne STATUS_SUCCESS. Si la limite géographique ne peut pas être supprimée, un code d’échec, STATUS_UNSUCCESSFUL, est retourné. En cas de défaillance, l’adaptateur GNSS émet la commande GNSS_ResetGeofencesTracking et recrée les limites géographiques souhaitées. Si cette commande supprime la dernière limite géographique définie, le pilote arrête le suivi des limites géographiques.