Fonction FltCbdqEnable (fltkernel.h)

Article
02/26/2024

FltCbdqEnable active une file d’attente de données de rappel qui a été désactivée par un appel précédent à FltCbdqDisable.

Syntaxe

VOID FLTAPI FltCbdqEnable(
  [in, out] PFLT_CALLBACK_DATA_QUEUE Cbdq
);

Paramètres

[in, out] Cbdq

Pointeur vers la file d’attente de données de rappel.

Valeur de retour

None

Remarques

FltCbdqEnable réactive une file d’attente de données de rappel qui a été désactivée par un appel précédent à FltCbdqDisable. Une fois la file d’attente de données de rappel réactivée, elle peut à nouveau accepter de nouveaux éléments.

Les pilotes Minifilter peuvent utiliser les routines FltCbdqXxx pour implémenter une file d’attente de données de rappel pour les opérations d’E/S basées sur IRP. En utilisant ces routines, les pilotes minifilter peuvent rendre leur file d’attente cancel-safe ; le système gère en toute transparence l’annulation des E/S pour le pilote minifilter.

Les routines FltCbdqXxx ne peuvent être utilisées que pour les opérations d’E/S basées sur IRP. Pour déterminer si une structure de données de rappel donnée représente une opération d’E/S basée sur IRP, utilisez la macro FLT_IS_IRP_OPERATION .

Si la file d’attente est protégée par un verrou de rotation plutôt qu’un objet mutex ou une variable de ressource, l’appelant de FltCbdqEnable peut s’exécuter sur IRQL <= DISPATCH_LEVEL. Si un mutex ou une ressource est utilisé, l’appelant doit s’exécuter sur IRQL <= APC_LEVEL.