Fonction FltFindExtraCreateParameter (fltkernel.h)

Article
02/26/2024

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

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 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] 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 a la valeur 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 est défini sur zéro.

Valeur retournée

FltFindExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	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 ).

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