FltRemoveExtraCreateParameter, fonction (fltkernel.h)

Article
02/06/2025

Le FltRemoveExtraCreateParameter routine recherche une liste ECP pour une structure de contexte ECP et, si elle est trouvée, la détache de la liste ECP.

Syntaxe

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

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, out] EcpList

Pointeur vers la liste de paramètres de création supplémentaire (ECP) qui contient la structure de contexte ECP à détacher de la liste donnée.

[in] EcpType

Pointeur vers un GUID défini par l’utilisateur qui identifie de manière unique la structure de contexte ECP à détacher de la liste.

[out] EcpContext

Pointeur vers la structure de contexte ECP détachée. Si la structure de contexte ECP est correctement détachée de la liste donnée, ce paramètre est défini pour pointer vers la structure de contexte ECP détachée. Si la structure de contexte ECP n’est pas trouvée dans la liste ECP donnée, ce paramètre est défini sur null.

[out, optional] EcpContextSize

Paramètre facultatif qui reçoit la taille de la structure de contexte ECP détachée. Si ce paramètre est présent lorsque la routine est appelée, le paramètre reçoit la taille, en octets, de la structure de contexte ECP détachée. Si la structure de contexte ECP donnée n’a pas été trouvée dans la liste ECP donnée, ce paramètre n’est pas défini.

Valeur de retour

FltRemoveExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	La structure de contexte ECP donnée a été correctement détachée de la liste ECP donnée.
STATUS_NOT_FOUND	La structure de contexte ECP donnée n’a pas été trouvée dans la liste ECP donnée.

Remarques

La routine FltRemoveExtraCreateParameter recherche la liste ECP donnée par le paramètre EcpList pour une structure de contexte ECP donnée par le paramètre EcpType. Si la structure de contexte ECP existe dans la liste, elle est détachée de la liste, le paramètre EcpContext est défini pour pointer vers celle-ci et la routine retourne STATUS_SUCCESS. Si la structure de contexte ECP n’existe pas dans la liste, le paramètre EcpContext est défini sur NULL et la routine retourne STATUS_NOT_FOUND.

Remarque Cette routine ne libère pas le pool de mémoire pour la structure de contexte ECP. Pour libérer la structure de contexte ECP, appelez d’abord cette routine pour la détacher de la liste, puis appelez la routine FltFreeExtraCreateParameter routine pour libérer la structure de contexte ECP elle-même.

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