Fungsi ExFreeToNPagedLookasideList (wdm.h)

Rutinitas ExFreeToNPagedLookasideList mengembalikan entri yang tidak disebarkan ke daftar lookaside yang diberikan atau ke kumpulan yang tidak dipaged.

Sintaksis

C++
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. Pemanggil memperoleh pointer ini dari panggilan sebelumnya ke ExAllocateFromNPagedLookasideList.

Mengembalikan nilai

Tidak

Komentar

Perhatian

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

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

Entri yang sama dapat dialokasikan atau entri lain yang 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 Entri dirilis ke kumpulan yang tidak disebarkan menggunakan rutinitas Free yang disediakan pemanggil, jika ada, yang disiapkan ketika daftar lookaside diinisialisasi atau ExFreePool.

Untuk informasi selengkapnya, lihat Menggunakan Daftar Lookaside.

Persyaratan

Syarat Nilai
klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Platform Target 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