Fonction FltPrepareToReuseEcp (fltkernel.h)
La routine FltPrepareToReuseEcp réinitialise une structure de contexte de paramètre de création supplémentaire (ECP), qui la prépare à la réutilisation.
Syntaxe
VOID FLTAPI FltPrepareToReuseEcp(
[in] PFLT_FILTER Filter,
[in] PVOID EcpContext
);
Paramètres
[in] Filter
Pointeur de filtre opaque pour le pilote de minifiltre. Ce pointeur identifie de manière unique le pilote de minifiltre et reste constant tant que le pilote de minifiltre est chargé.
[in] EcpContext
Pointeur vers l’ECP pour préparer la réutilisation.
Valeur retournée
Aucun.
Notes
FltPrepareToReuseEcp permet la réutilisation d’un ECP utilisé dans une demande de création précédente. Cela évite d’avoir à initialiser un nouvel ECP avec les mêmes informations.
La cible d’un PCE utilise FltAcknowledgeEcp pour marquer l’ECP comme reconnu. Cela indique que l’ECP a été découvert et traité. Pour réutiliser un ECP précédemment reconnu, par exemple lors du traitement d’une analyse, un pilote peut utiliser FltPrepareToReuseEcp pour effacer l’état reconnu de l’ECP avant de l’envoyer dans une autre demande de création.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8. |
| Plateforme cible | Universal |
| En-tête | fltkernel.h (inclure Fltkernel.h) |
| Bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |