IOCTL_GNSS_DELETE_GEOFENCE IOCTL (driver.h)

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

Note S’applique à DESKTOP 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éfinir 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, état de la condition d’erreur appropriée en tant que code NTSTATUS .

Remarques

NTSTATUS avec les indications suivantes :

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

Notes de l’adaptateur SQL

L’adaptateur CIP 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 rajoute les limites géographiques.

Notes du pilote JDBC

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 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 d’échec, 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.

Configuration requise

   
En-tête driver.h

Voir aussi

Création de requêtes IOCTL dans les pilotes

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously