FltCbdqEnable, fonction (fltkernel.h)
FltCbdqEnable active une file d’attente de données de rappel 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
Aucun
Remarques
FltCbdqEnable réenable une file d’attente de données de rappel désactivée par un appel précédent à FltCbdqDisable. Une fois la file d’attente de données de rappel réenable, 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 de manière transparente 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 de ou une variable de ressource , l’appelant de FltCbdqEnable peut s’exécuter à l'<IRQL = DISPATCH_LEVEL. Si un mutex ou une ressource est utilisé, l’appelant doit s’exécuter à l'<IRQL = APC_LEVEL.
Exigences
Exigence | Valeur |
---|---|
plateforme cible | Universel |
d’en-tête | fltkernel.h (include Fltkernel.h) |
IRQL | Voir la section Remarques |