FltInitExtraCreateParameterLookasideList-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltInitExtraCreateParameterLookasideList 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 FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger auf den Minifiltertreiber. Dieser Zeiger identifiziert den Minifiltertreiber eindeutig und bleibt konstant, solange der Minifiltertreiber geladen wird.

[in, out] Lookaside

Zeiger auf eine undurchsichtige PAGED_LOOKASIDE_LIST oder NPAGED_LOOKASIDE_LIST Lookaside-Listenkopfstruktur. Für eine ausgelagerte oder nicht ausgelagerte Lookaside-Liste muss die Listenkopfstruktur aus nicht ausgelagertem Pool zugewiesen werden.

[in] Flags

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

[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 ausgelagerte oder nicht ausgelagerte Pool-Lookaside-Liste zu initialisieren. Verwenden Sie die FltAllocateExtraCreateParameterFromLookasideList Routine, um ein ECP aus der Lookaside-Liste zuzuweisen, und die FltFreeExtraCreateParameter Routine, um einen ECP-Puffer zur Lookaside-Liste für das Recycling zurückzugeben.

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

Fahrer müssen alle ECPs und Lookaside-Listen freigeben, die sie vor dem Entladen erstellt haben.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Die FltInitExtraCreateParameterLookasideList-Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	<= APC_LEVEL