Partager via


IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Un client envoie la demande IOCTL_NFP_DISABLE pour désactiver temporairement les abonnements, les publications et les événements de présence. Cela est utile lorsqu’un client souhaite désactiver la fonctionnalité de proximité, mais conserver les ressources allouées pour les réactiver rapidement si nécessaire.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

None

Mémoire tampon de sortie

None

Bloc d’état

Irp-IoStatus.Status> est défini sur STATUS_SUCCESS si la demande réussit.

Sinon, état à la condition d’erreur appropriée en tant que code NTSTATUS.

Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

Les actions suivantes sont requises lors de l’utilisation de cet IOCTL :

  • Lorsque ce IOCTL est reçu, le pilote DOIT marquer le handle de fichier comme « Désactivé ».
  • Si un handle d’abonnement est remplacé par « Désactivé », le fournisseur DOIT supprimer tous les messages de la file d’attente « Reçu » de ce handle de fichier.
  • Si un handle d’abonnement est « Désactivé » :
    • Le pilote DOIT conserver la file d’attente « Reçue » de ce handle à une longueur nulle en purgant (supprimant) les messages existants dans la file d’attente et en supprimant les nouveaux messages de la file d’attente dès qu’ils sont reçus.
    • Le pilote DOIT terminer toutes les demandes de IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE suspendus sur ce handle avec STATUS_CANCELLED.
  • Si un handle de publication est « désactivé », le fournisseur NE DOIT PAS transmettre le message de la publication et il DOIT terminer toutes les demandes de IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE suspendus sur ce handle avec STATUS_CANCELLED

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
En-tête nfpdev.h

Voir aussi

IOCTL_NFP_ENABLE

Guide de conception globale de la communication en champ proche (NFC)

Guide de conception de proximité en champ proche (Tap and Do, modèle de fournisseur NFP, exigences du pilote)