FsRtlInitExtraCreateParameterLookasideList, fonction (ntifs.h)

Article
12/21/2024

La FsRtlInitExtraCreateParameterLookasideList routine 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 FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Paramètres

[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, FsRtlInitExtraCreateParameterLookasideList initialise une liste lookaside pour les entrées ECP non paginées de la taille spécifiée. Sinon, FsRtlInitExtraCreateParameterLookasideList initialise une liste lookaside 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 FsRtlAllocateExtraCreateParameterFromLookasideList pour allouer un programme ECP à partir de la liste lookaside et la routine FsRtlFreeExtraCreateParameter routine pour retourner une mémoire tampon ECP à la liste lookaside pour le recyclage.

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

Les pilotes doivent libérer toutes les PPE et listes de choix qu’ils créent avant de décharger.

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 FsRtlInitExtraCreateParameterLookasideList est disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL