FsRtlInitExtraCreateParameterLookasideList-Funktion (ntifs.h)

Artikel
02/29/2024

Die FsRtlInitExtraCreateParameterLookasideList-Routine initialisiert eine ausgelagerte oder nicht ausgelagerte Pool-Lookasideliste, die für die Zuordnung einer oder mehrerer zusätzlicher Create-Parameterkontextstrukturen (ECPs) 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 list-head-Struktur. Für eine ausgelagerte oder nicht ausgelagerte Suchliste 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 Bitflaggenwert enthält, initialisiert FsRtlInitExtraCreateParameterLookasideList eine Suchliste für nicht ausseitige ECP-Einträge der angegebenen Größe. Andernfalls initialisiert FsRtlInitExtraCreateParameterLookasideList 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 auf der Seite der Suchliste 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-Lookasideliste zu initialisieren. Verwenden Sie die FsRtlAllocateExtraCreateParameterFromLookasideList-Routine , um ein 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 Suchliste selbst zu befreien.

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

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Die FsRtlInitExtraCreateParameterLookasideList-Routine ist ab Windows Vista verfügbar.
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL