FltInsertExtraCreateParameter, fonction (fltkernel.h)

Article
02/06/2025

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 minifilter. Ce pointeur identifie de façon unique le pilote minifilter et reste constant tant que le pilote minifilter est chargé.

[in, out] EcpList

Pointeur vers la structure de liste ECP vers 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, fourni par le paramètre EcpList.

Valeur de retour

FltInsertExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	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 routine.

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.

Exigences

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