Bagikan melalui


Fungsi KeRemoveQueueDpc (wdm.h)

Rutinitas KeRemoveQueueDpc menghapus objek DPC yang ditentukan dari antrean DPC sistem.

Sintaks

BOOLEAN KeRemoveQueueDpc(
  [in, out] PRKDPC Dpc
);

Parameter

[in, out] Dpc

Penunjuk ke objek DPC yang diinisialisasi yang diantrekan oleh panggilan sebelumnya ke rutinitas KeInsertQueueDpc .

Nilai kembali

KeRemoveQueueDpc mengembalikan TRUE jika objek DPC berada dalam antrean DPC. Jika objek DPC yang ditentukan saat ini tidak berada dalam antrean DPC, tidak ada operasi yang dilakukan dan FALSE dikembalikan.

Keterangan

Jika objek DPC yang ditentukan saat ini diantrekan, objek tersebut dihapus dari antrean, membatalkan panggilan ke rutinitas DPC terkait.

Dimulai dengan Windows Vista dengan Paket Layanan 1 (SP1) dan Windows Server 2008, nilai pengembalian TRUE selalu berarti bahwa KeRemoveQueueDpc berhasil menghapus objek DPC dari antrean DPC sebelum rutinitas DPC mulai berjalan. Di versi Windows sebelumnya, rutinitas DPC mungkin kadang-kadang berjalan bahkan jika KeRemoveQueueDpc mengembalikan TRUE. Dalam versi Windows sebelumnya ini, driver yang tidak dapat mentolerir ambiguitas dalam nilai pengembalian TRUE harus memperlakukan nilai pengembalian TRUE dan FALSE secara identik.

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 Tingkat apa pun
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport)

Lihat juga

KeInitializeDpc

KeInsertQueueDpc