Partager via


Fonction FsRtlPrepareToReuseEcp (ntifs.h)

La routine FsRtlPrepareToReuseEcp réinitialise une structure de contexte de paramètre de création supplémentaire (ECP) qui la prépare à la réutilisation.

Syntaxe

void FsRtlPrepareToReuseEcp(
  [in] PVOID EcpContext
);

Paramètres

[in] EcpContext

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

Valeur de retour

None

Remarques

Le FsRtlPrepareToReuseEcp 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 FsRtlAcknowledgeEcp pour marquer l’ECP comme étant 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 FsRtlPrepareToReuseEcp pour effacer l’état reconnu de l’ECP avant de l’envoyer dans une autre demande de création.

Dans un pilote de minifiltre de système de fichiers, utilisez FltPrepareToReuseEcp pour réutiliser un ECP.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

ECP_LIST

FltPrepareToReuseEcp

FsRtlInsertExtraCreateParameter

FltIsEcpAcknowledged

FsRtlRemoveExtraCreateParameter