Fungsi FltInitExtraCreateParameterLookasideList (fltkernel.h)

Artikel
03/01/2024

Rutinitas FltInitExtraCreateParameterLookasideList menginisialisasi daftar lookaside kumpulan halaman atau non-halaman yang digunakan untuk alokasi satu atau beberapa struktur konteks parameter buat tambahan (ECP) dengan ukuran tetap.

Sintaks

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

Penunjuk filter buram ke driver minifilter. Pointer ini secara unik mengidentifikasi driver minifilter dan tetap konstan selama driver minifilter dimuat.

[in, out] Lookaside

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

[in] Flags

Menentukan opsi alokasi kumpulan. Jika parameter Bendera berisi nilai bendera bit FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, rutin menginisialisasi daftar lookaside untuk entri ECP non-halaman dari ukuran yang ditentukan. Jika tidak, rutinitas 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 tampilan kumpulan halaman atau non-halaman. Gunakan rutinitas FltAllocateExtraCreateParameterFromLookasideList untuk mengalokasikan ECP dari daftar lookaside, dan rutinitas FltFreeExtraCreateParameter untuk mengembalikan buffer ECP ke daftar lookaside untuk daur ulang.

Gunakan rutinitas FltDeleteExtraCreateParameterLookasideList untuk membebaskan daftar lookaside itu sendiri.

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

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas FltInitExtraCreateParameterLookasideList tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL