IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Article
03/01/2024

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