IOCTL_GNSS_DELETE_GEOFENCE IOCTL (ombadriver.h)

Article
02/07/2025

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

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

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Pointeur vers une structure 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éfini sur 0.

Bloc d’état

> IoStatus.Status est défini sur STATUS_SUCCESS si la requête réussit. Sinon, état à la condition d’erreur appropriée en tant que code NTSTATUS.

Remarques

NTSTATUS avec les indications suivantes :

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

Notes de l’adaptateur DIMENSIONNELLE

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

Notes du pilote PSEC

S’il s’agit de la dernière limite géographique, le pilote JDBC doit arrêter le suivi de la limite géographique. Si le moteur ORÉAL n’a pas pu suivre les limites géographiques (en raison de conditions de signal incorrectes 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é. Si une défaillance se produit, l’adaptateur TABLEAUX é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 de la limite géographique.