Fonction FltGetNextExtraCreateParameter (fltkernel.h)

Article
08/07/2023

La routine FltGetNextExtraCreateParameter retourne un pointeur vers la structure de contexte de paramètre de création (ECP) suivante (ou première) supplémentaire dans une liste ECP donnée.

Syntaxe

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

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

Pointeur vers la liste ECP à examiner.

[in, optional] CurrentEcpContext

Pointeur facultatif vers un ECP dans la liste ECP donnée. Le cas échéant, FltGetNextExtraCreateParameter retourne l’ECP après l’ECP CurrentEcpContext . Si CurrentEcpContext a la valeur NULL, FltGetNextExtraCreateParameter retourne le premier ECP de la liste.

[out, optional] NextEcpType

Paramètre facultatif qui reçoit un pointeur vers le GUID de l’ECP retourné.

[out, optional] NextEcpContext

Paramètre facultatif qui reçoit un pointeur vers l’ECP retourné.

[out, optional] NextEcpContextSize

Paramètre facultatif qui reçoit la taille, en octets, de l’ECP retourné.

Valeur retournée

FltGetNextExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	Un ECP a été trouvé dans la liste EcpList ECP.
STATUS_NOT_FOUND	La liste ECP EcpList est vide ou CurrentEcpContext est le dernier ECP de la liste, c’est-à-dire qu’il n’y a pas d’élément de liste ECP suivant). En outre, NextEcpContext a la valeur NULL et NextEcpContextSize a la valeur zéro.
STATUS_INVALID_PARAMETER	Le paramètre EcpList a la valeur NULL.

Remarques

Cette routine est disponible à partir de Windows Vista.

La routineFltGetNextExtraCreateParameter traite une liste ECP de manière non circulaire. Autrement dit, si l’ECP signalé par le paramètre CurrentEcpContext est le dernier élément ECP de la liste ECP, il n’y a pas d’ECP « suivant » dans la liste et la routine retourne STATUS_NOT_FOUND.

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