FltInitExtraCreateParameterLookasideList-Funktion (fltkernel.h)

Artikel
03/01/2024

Die FltInitExtraCreateParameterLookasideList-Routine initialisiert eine ausgelagerte oder nicht ausgelagerte 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. Bei einer ausgelagerten oder nicht ausgelagerten Lookaside-Liste muss die Listenkopfstruktur aus einem nicht ausgelagerten Pool zugeordnet werden.

[in] Flags

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

[in] Size

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

[in] Tag

Gibt das Pooltag an, das beim Zuweisen von ECP-Einträgen in der Lookaside-Liste verwendet werden soll. Weitere Informationen zu Pooltags finden Sie im Tag-Parameter von ExAllocatePoolWithTag.

Rückgabewert

Keine

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 zuzuordnen, und die FltFreeExtraCreateParameter-Routine , um einen ECP-Puffer zur Lookaside-Liste zum Recycling zurückzugeben.

Verwenden Sie die FltDeleteExtraCreateParameterLookasideList-Routine , um die Lookaside-Liste selbst frei zu geben.

Treiber müssen alle ECPs und Suchlisten freigeben, die sie vor dem Entladen erstellt haben.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Die FltInitExtraCreateParameterLookasideList-Routine ist ab Windows Vista verfügbar.
Zielplattform	Universell
Header	fltkernel.h (fltkernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL