Fungsi KeRemoveByKeyDeviceQueue (wdm.h)

  • Artikel

Rutinitas KeRemoveByKeyDeviceQueue menghapus entri, dipilih sesuai dengan nilai kunci pengurutan, dari antrean perangkat yang ditentukan.

Sintaks

PKDEVICE_QUEUE_ENTRY KeRemoveByKeyDeviceQueue(
  [in, out] PKDEVICE_QUEUE DeviceQueue,
  [in]      ULONG          SortKey
);

Parameter

[in, out] DeviceQueue

Arahkan ke objek antrean perangkat yang diinisialisasi yang disediakan pemanggil penyimpanan.

[in] SortKey

Menentukan kunci yang akan digunakan saat mencari DeviceQueue.

Nilai kembali

KeRemoveByKeyDeviceQueue mengembalikan entri antrean perangkat yang dihapus; mengembalikan NULL jika antrean kosong.

Keterangan

Rutinitas ini mencari entri pertama dalam antrean perangkat yang memiliki nilai lebih besar dari atau sama dengan SortKey. Setelah entri ini ditemukan, rutinitas ini menghapus entri dari antrean perangkat dan mengembalikannya. Jika tidak ada entri seperti itu yang ditemukan, maka entri pertama dalam antrean dikembalikan. Jika antrean perangkat kosong, maka perangkat diatur ke status tidak sibuk dan penunjuk NULL dikembalikan.

Ini adalah kesalahan untuk memanggil KeRemoveByKeyDeviceQueue ketika objek antrean perangkat diatur ke status tidak sibuk.

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 DISPATCH_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Lihat juga

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue