Fonction FltInsertExtraCreateParameter (fltkernel.h)

Article
02/27/2024

La routine FltInsertExtraCreateParameter insère une structure de contexte de paramètre de création supplémentaire (ECP) dans une liste ECP.

Syntaxe

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Paramètres

[in] Filter

Pointeur de filtre opaque vers 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, out] EcpList

Pointeur vers la structure de liste ECP à laquelle la structure de contexte ECP, fournie par le paramètre EcpContext , doit être ajoutée.

[in, out] EcpContext

Pointeur vers la structure de contexte ECP à ajouter à la liste ECP, fournie par le paramètre EcpList .

Valeur retournée

FltInsertExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	La structure de contexte ECP donnée a été correctement insérée dans la liste ECP donnée.
STATUS_INVALID_PARAMETER	La structure de contexte ECP donnée existe déjà dans la liste ECP donnée. Dans le contexte de l’insertion de liste ECP, deux structures de contexte ECP sont considérées comme identiques si elles contiennent des valeurs GUID égales.

Remarques

La routine FltInsertExtraCreateParameter suppose que la structure de contexte ECP donnée à insérer dans la liste ECP donnée a été précédemment allouée par la routine FltAllocateExtraCreateParameter .

Chaque structure de contexte ECP insérée dans la liste ECP doit avoir une valeur GUID unique. Cette valeur unique est définie lorsque la structure de contexte ECP est allouée par la routine FltAllocateExtraCreateParameter .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible à partir de Windows Vista.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL