Fungsi ExFreeToPagedLookasideList (wdm.h)
Rutinitas ExFreeToPagedLookasideList mengembalikan entri yang dapat dipahami ke daftar lookaside yang diberikan atau ke kumpulan halaman.
Sintaks
void ExFreeToPagedLookasideList(
[in, out] PPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Parameter
[in, out] Lookaside
Penunjuk ke struktur PAGED_LOOKASIDE_LIST untuk daftar lookaside, yang sudah diinisialisasi pemanggil dengan ExInitializePagedLookasideList, yang sudah diinisialisasi pemanggil dengan ExInitializePagedLookasideList.
[in] Entry
Penunjuk ke entri yang akan dikosongkan. Penelepon memperoleh pointer ini dari panggilan sebelumnya ke ExAllocateFromPagedLookasideList.
Nilai kembali
Tidak ada
Keterangan
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 Konfigurasi Properti-Pengaturan> Driver-Umum>.
ExFreeToPagedLookasideList adalah timbal balik dari ExAllocateFromPagedLookasideList. Ini merilis entri penelepon yang dialokasikan kembali ke daftar lookaside penelepon atau ke kumpulan halaman ketika entri tersebut tidak lagi digunakan.
Entri yang sama dapat direalokasikan atau entri lain dapat dialokasikan nanti dengan panggilan berikutnya ke ExAllocateFromPagedLookasideList. Pengguna daftar lookaside dapat mengalokasikan dan membebaskan entri tersebut secara dinamis, sesuai kebutuhan, sampai memanggil ExDeletePagedLookasideList. ExDeletePagedLookasideList 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, ExFreeToPagedLookasideList menyisipkan entri yang diberikan di bagian depan daftar. Jika tidak, buffer di Entry dirilis kembali ke kumpulan halaman menggunakan rutinitas Gratis yang disediakan penelepon, jika ada, yang disiapkan ketika daftar lookaside diinisialisasi atau ExFreePool.
Pada Windows 2000, driver harus menggunakan tombol -D_WIN2K_COMPAT_SLIST_USAGE untuk berhasil menautkan kode yang menggunakan ExFreeToPagedLookasideList.
Untuk informasi selengkapnya, lihat Menggunakan Lists Lookaside.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Lihat juga
ExAllocateFromPagedLookasideList