Fungsi KeRundownQueue (ntifs.h)
Rutinitas KeRundownQueue membersihkan objek antrean, membersihkan entri antrean apa pun.
Sintaks
PLIST_ENTRY KeRundownQueue(
[in, out] PRKQUEUE Queue
);
Parameter
[in, out] Queue
Penunjuk ke objek antrean yang diinisialisasi yang pemanggilnya menyediakan penyimpanan residen di kumpulan yang tidak disebarkan.
Nilai kembali
Jika antrean kosong, KeRundownQueue mengembalikan NULL; jika tidak, ia mengembalikan alamat entri pertama dalam antrean.
Keterangan
Sistem file memanggil KeRundownQueue untuk membuang semua entri dari antrean sebelum membebaskan atau menggunakan kembali objek antrean.
Jika objek antrean akan digunakan kembali, pemanggil harus memanggil KeInitializeQueue setelah memanggil KeRundownQueue, untuk menginisialisasi ulang objek antrean sebelum menggunakannya kembali.
KeRundownQueue tidak mengembalikan informasi tentang berapa banyak entri antrean yang dibuang.
Mulai Windows 7, KeRundownQueue membangunkan utas apa pun yang saat ini menunggu objek antrean dengan STATUS_ABANDONED. Setelah kembali dari fungsi ini, setiap utas di masa mendatang yang mencoba menunggu pada antrean ini akan segera gagal dengan STATUS_ABANDONED.
Sebelum Windows 7, KeRundownQueue tidak bangun menunggu utas ketika antrean rundown. Untuk menghindari kemungkinan meninggalkan utas menunggu selamanya pada versi OS ini, KeRundownQueue tidak boleh dipanggil untuk antrean jika ada utas yang menunggu pada objek antrean.
Untuk informasi selengkapnya tentang menggunakan antrean internal yang dikelola driver, lihat Antrean yang Dikelola Driver.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | ntifs.h (termasuk Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |