FltInitExtraCreateParameterLookasideList, fonction (fltkernel.h)

Article
02/06/2025

La routine FltInitExtraCreateParameterLookasideList initialise une liste de choix de pool paginée ou non paginée utilisée pour l’allocation d’une ou plusieurs structures de contexte de paramètre 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 minifilter. Ce pointeur identifie de façon unique le pilote minifilter et reste constant tant que le pilote minifilter est chargé.

[in, out] Lookaside

Pointeur vers un PAGED_LOOKASIDE_LIST opaque ou NPAGED_LOOKASIDE_LIST structure de tête de liste à côté. Pour une liste de choix 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 de l’indicateur de bits FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, la routine initialise une liste de choix pour les entrées ECP non paginées de la taille spécifiée. Sinon, la routine initialise une liste de choix pour les entrées ECP paginées de la taille spécifiée.

[in] Size

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

[in] Tag

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

Valeur de retour

Aucun

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 lookaside et la routine FltFreeExtraCreateParameter pour retourner une mémoire tampon ECP à la liste lookaside pour le recyclage.

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

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

Pour plus d’informations sur l’utilisation de listes lookaside avec des pilotes, consultez Using Lookaside Lists.

Exigences

Exigence	Valeur
client minimum pris en charge	La routine FltInitExtraCreateParameterLookasideList 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