Fonction FsRtlPrepareToReuseEcp (ntifs.h)

Article
02/26/2024

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