Fungsi ExFreeToNPagedLookasideList (wdm.h)

  • Artikel

Rutinitas ExFreeToNPagedLookasideList mengembalikan entri yang tidak ditumpuk ke daftar lookaside yang diberikan atau ke kumpulan yang tidak dipagasi.

Sintaks

void ExFreeToNPagedLookasideList(
  [in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
  [in]      PVOID                  Entry
);

Parameter

[in, out] Lookaside

Penunjuk ke struktur NPAGED_LOOKASIDE_LIST untuk daftar lookaside, yang sudah diinisialisasi pemanggil dengan ExInitializeNPagedLookasideList.

[in] Entry

Penunjuk ke entri yang akan dibebaskan. Penelepon memperoleh pointer ini dari panggilan sebelumnya ke ExAllocateFromNPagedLookasideList.

Nilai kembali

Tidak ada

Keterangan

Perhatian

Mulai Windows 11, versi 22H2, fungsi ini berubah dari sebaris menjadi diekspor. Akibatnya, jika Anda membangun driver yang menargetkan versi terbaru Windows, driver akan gagal dimuat dalam versi OS yang lebih lama. Untuk mengubah versi OS target di Visual Studio, pilih Konfigurasi Properti-Pengaturan> Driver-Umum>.

ExFreeToNPagedLookasideList adalah timbal balik dari ExAllocateFromNPagedLookasideList. Ini merilis entri penelepon yang dialokasikan kembali ke daftar tampilan penelepon atau ke kumpulan yang tidak di-patahkan ketika entri tersebut tidak lagi digunakan.

Entri yang sama dapat dialokasikan atau entri lain dialokasikan nanti dengan panggilan berikutnya ke ExAllocateFromNPagedLookasideList. Pengguna daftar lookaside dapat mengalokasikan dan membebaskan entri tersebut secara dinamis sesuai kebutuhan sampai memanggil ExDeleteNPagedLookasideList, yang merilis entri yang luar biasa dalam daftar sebelum menghapus status sistem untuk daftar lookaside yang diberikan dan mengembalikan kontrol.

Jika daftar lookaside yang ditentukan belum mencapai jumlah entri maksimum yang ditentukan sistem, ExFreeToNPagedLookasideList menyisipkan entri yang diberikan di bagian depan daftar. Jika tidak, buffer di Entry dirilis ke kumpulan non-halaman menggunakan rutinitas Gratis yang disediakan penelepon, jika ada, yang disiapkan ketika daftar lookaside diinisialisasi atau ExFreePool.

Untuk informasi selengkapnya, lihat Menggunakan Lists Lookaside.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI SpIrql(storport)

Lihat juga

ExAllocateFromNPagedLookasideList

ExDeleteNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST