Fungsi FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Artikel
02/26/2024

FsRtlInitExtraCreateParameterLookasideList rutin menginisialisasi daftar lookaside kumpulan halaman atau tidak berpaginasi yang digunakan untuk alokasi satu atau beberapa struktur konteks parameter buat tambahan (EKP) dengan ukuran tetap.

Sintaks

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

Parameter

[in, out] Lookaside

Penunjuk ke struktur kepala daftar PAGED_LOOKASIDE_LIST buram atau NPAGED_LOOKASIDE_LIST terlihat. Untuk daftar tampilan halaman atau yang tidak di-halaman, struktur kepala daftar harus dialokasikan dari kumpulan yang tidak di-halaman.

[in] Flags

Menentukan opsi alokasi kumpulan. Jika parameter Bendera berisi nilai bendera bit FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, FsRtlInitExtraCreateParameterLookasideList menginisialisasi daftar lookaside untuk entri ECP yang tidak di-patahkan dari ukuran yang ditentukan. Jika tidak, FsRtlInitExtraCreateParameterLookasideList menginisialisasi daftar lookaside untuk entri ECP halaman dengan ukuran yang ditentukan.

[in] Size

Menentukan ukuran, dalam byte, untuk semua entri ECP dalam daftar tampilan.

[in] Tag

Menentukan tag kumpulan yang akan digunakan saat mengalokasikan entri ECP daftar lookaside. Untuk informasi selengkapnya tentang tag kumpulan, lihat Parameter tagExAllocatePoolWithTag.

Nilai kembali

Tidak ada

Keterangan

Gunakan rutinitas ini untuk menginisialisasi daftar lookaside kumpulan berpakaian halaman atau tidak bertumpuk. Gunakan rutinitas FsRtlAllocateExtraCreateParameterFromLookasideList untuk mengalokasikan ECP dari daftar lookaside, dan rutinitas FsRtlFreeExtraCreateParameter untuk mengembalikan buffer ECP ke daftar lookaside untuk daur ulang.

Gunakan rutinitas FsRtlDeleteExtraCreateParameterLookasideList untuk membebaskan daftar lookaside itu sendiri.

Driver harus membebaskan semua ECP dan daftar lookaside yang mereka buat sebelum dibongkar.

Untuk informasi selengkapnya tentang menggunakan daftar lookaside dengan driver, lihat Menggunakan Lookaside Lists.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas FsRtlInitExtraCreateParameterLookasideList tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL