FltFindExtraCreateParameter, fonction (fltkernel.h)

Article
02/06/2025

Le FltFindExtraCreateParameter routine recherche une liste ECP donnée pour une structure de contexte ECP d’un type donné et retourne un pointeur vers cette structure s’il est trouvé.

Syntaxe

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] 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] EcpList

Pointeur vers la structure de liste ECP dans laquelle rechercher la structure de contexte ECP (donnée par le paramètre EcpType).

[in] EcpType

Pointeur vers un GUID qui identifie de manière unique chaque structure de contexte ECP. Cette valeur GUID est utilisée par la routine FltFindExtraCreateParamter pour déterminer si la structure de contexte ECP existe dans la liste ECP (donnée par le paramètre EcpList).

[out, optional] EcpContext

Paramètre facultatif qui reçoit un pointeur vers la structure de contexte ECP trouvée. Si la structure de contexte ECP est introuvable dans la liste ECP, ecpContext est définie sur NULL. Si EcpContext est défini sur NULL par l’appelant, la valeur de retour de cette routine peut être utilisée pour déterminer si la structure de contexte ECP se trouve dans la liste ECP.

[out, optional] EcpContextSize

Paramètre facultatif qui reçoit la taille, en octets, de la structure de contexte ECP trouvée. Si la structure de contexte ECP est introuvable dans la liste ECP, EcpContextSize a la valeur zéro.

Valeur de retour

FltFindExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	La structure de contexte ECP (telle que spécifiée par le paramètre EcpType) a été trouvée dans la liste ECP (comme spécifié par le paramètre EcpList).
STATUS_NOT_FOUND	La structure de contexte ECP (telle que spécifiée par le paramètre EcpType) n’a pas été trouvée dans la liste ECP (comme spécifié par le paramètre EcpList).

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