FsRtlInitExtraCreateParameterLookasideList-Funktion (ntifs.h)
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 |
Weitere Informationen
FsRtlAllocateExtraCreateParameterFromLookasideList