FsRtlInitExtraCreateParameterLookasideList-Funktion (ntifs.h)

Artikel
12/20/2024

Die FsRtlInitExtraCreateParameterLookasideList Routine initialisiert eine ausgelagerte oder nicht seitenseitige Pool-Lookaside-Liste, die für die Zuordnung einer oder mehrerer zusätzlicher Create-Parameterkontextstrukturen (ECPs) mit fester Größe verwendet wird.

Syntax

void FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parameter

[in, out] Lookaside

Zeiger auf eine undurchsichtige PAGED_LOOKASIDE_LIST oder NPAGED_LOOKASIDE_LIST Lookaside-Listenkopfstruktur. Bei einer ausgelagerten oder nicht ausgelagerten Lookaside-Liste muss die Listenkopfstruktur aus nicht seitenseitigem Pool zugewiesen werden.

[in] Flags

Definiert Poolzuordnungsoptionen. Wenn der parameter Flags den FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL Bitkennzeichnungswert enthält, initialisiert FsRtlInitExtraCreateParameterLookasideList eine Lookaside-Liste für nicht seitenseitige ECP-Einträge der angegebenen Größe initialisiert. Andernfalls initialisiert FsRtlInitExtraCreateParameterLookasideList eine Lookaside-Liste für seitenseitige ECP-Einträge der angegebenen Größe initialisiert.

[in] Size

Gibt die Größe in Bytes für alle ECP-Einträge in der Lookaside-Liste an.

[in] Tag

Gibt das Pooltag an, das beim Zuordnen von ECP-Einträgen für Lookaside-Listen verwendet werden soll. Weitere Informationen zu Pooltags finden Sie im parameter Tag von ExAllocatePoolWithTag.

Rückgabewert

Nichts

Bemerkungen

Verwenden Sie diese Routine, um eine seitenseitige oder nicht seitenseitige Pool-Lookaside-Liste zu initialisieren. Verwenden Sie die FsRtlAllocateExtraCreateParameterFromLookasideList Routine, um eine ECP aus der Lookaside-Liste zuzuweisen, und die FsRtlFreeExtraCreateParameter Routine, um einen ECP-Puffer zur Lookaside-Liste zum Recycling zurückzugeben.

Verwenden Sie die FsRtlDeleteExtraCreateParameterLookasideList Routine, um die Lookaside-Liste selbst freizulassen.

Treiber müssen alle ECPs und Lookaside-Listen freigeben, die sie erstellen, bevor sie entladen werden.

Weitere Informationen zur Verwendung von Lookaside-Listen mit Treibern finden Sie unter Using Lookaside Lists.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Die FsRtlInitExtraCreateParameterLookasideList-Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL