Fonction FltInitExtraCreateParameterLookasideList (fltkernel.h)

Article
02/29/2024

La routine FltInitExtraCreateParameterLookasideList initialise une liste de recherche de pool paginée ou non paginée utilisée pour l’allocation d’une ou plusieurs structures de contexte de paramètres de création supplémentaires de taille fixe.

Syntaxe

VOID FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

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

Pointeur vers un PAGED_LOOKASIDE_LIST opaque ou NPAGED_LOOKASIDE_LIST structure de tête de liste lookaside. Pour une liste paginée ou non paginée, la structure de tête de liste doit être allouée à partir d’un pool non paginé.

[in] Flags

Définit les options d’allocation de pool. Si le paramètre Flags contient la valeur d’indicateur de bits FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, la routine initialise une liste de recherche pour les entrées ECP non paginées de la taille spécifiée. Sinon, la routine initialise une liste de recherche pour les entrées ECP paginées de la taille spécifiée.

[in] Size

Spécifie la taille, en octets, de toutes les entrées ECP de la liste de recherche.

[in] Tag

Spécifie la balise de pool à utiliser lors de l’allocation d’entrées ECP de liste de recherche. Pour plus d’informations sur les balises de pool, consultez le paramètre Tagd’ExAllocatePoolWithTag.

Valeur de retour

None

Remarques

Utilisez cette routine pour initialiser une liste de recherche de pool paginée ou non paginée. Utilisez la routine FltAllocateExtraCreateParameterFromLookasideList pour allouer un ECP à partir de la liste de recherche et la routine FltFreeExtraCreateParameter pour renvoyer une mémoire tampon ECP à la liste de recherche à des fins de recyclage.

Utilisez la routine FltDeleteExtraCreateParameterLookasideList pour libérer la liste de lookaside elle-même.

Les pilotes doivent libérer toutes les ecps et listes de lookaside qu’ils ont créées avant le déchargement.

Pour plus d’informations sur l’utilisation de listes de lookaside avec des pilotes, consultez Utilisation de lookaside Listes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La routine FltInitExtraCreateParameterLookasideList 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