IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Article
02/07/2025

Un client envoie la demande de 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

Aucun

Mémoire tampon de sortie

Aucun

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 ce 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 cette file d’attente « Reçue » à zéro longueur en purgeant (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 effectuer toutes les demandes IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE pendées 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 doit effectuer toutes les demandes d'IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE pendées sur ce handle avec STATUS_CANCELLED