Partager via


FltPrepareToReuseEcp, fonction (fltkernel.h)

Le FltPrepareToReuseEcp routine réinitialise une structure de contexte de paramètre de création supplémentaire (ECP), qui la prépare à être réutilisée.

Syntaxe

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Paramètres

[in] Filter

Pointeur de filtre opaque pour le pilote minifilter. Ce pointeur identifie de façon unique le pilote minifilter et reste constant tant que le pilote minifilter est chargé.

[in] EcpContext

Pointeur vers l’ECP pour préparer la réutilisation.

Valeur de retour

Aucun.

Remarques

Le FltPrepareToReuseEcp permet la réutilisation d’un ecP utilisé dans une demande de création précédente. Cela empêche l’initialisation d’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.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 8.
plateforme cible Universel
d’en-tête fltkernel.h (include Fltkernel.h)
bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Voir aussi

ECP_LIST

FltGetEcpListFromCallbackData

FltIsEcpAcknowledged

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

FltlInsertExtraCreateParameter