Fungsi IoStartNextPacketByKey (wdm.h)

  • Artikel

Rutinitas IoStartNextPacketByKey menghapus antrean paket permintaan I/O berikutnya dari antrean perangkat terkait objek perangkat yang ditentukan sesuai dengan nilai sort-key yang ditentukan dan memanggil rutinitas StartIo driver dengan IRP tersebut.

Sintaks

void IoStartNextPacketByKey(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] BOOLEAN        Cancelable,
  [in] ULONG          Key
);

Parameter

[in] DeviceObject

Arahkan ke objek perangkat tempat IRP akan dilepas antreannya.

[in] Cancelable

Menentukan apakah RUNP dalam antrean perangkat dapat dibatalkan.

[in] Key

Menentukan kunci pengurutan yang menentukan entri mana yang akan dihapus dari antrean.

Nilai kembali

Tidak ada

Keterangan

Jika saat ini tidak ada IRP dalam antrean perangkat untuk objek perangkat target, rutinitas ini hanya mengembalikan kontrol ke pemanggil.

Jika driver meneruskan pointer ke rutinitas pembatalan saat disebut IoStartPacket, driver harus meneruskan TRUE dalam parameter Yang dapat dibatalkan . Jika Dapat DibatalkanTRUE, manajer I/O akan menggunakan kunci putar batal untuk melindungi antrean perangkat dan IRP saat ini.

Driver yang tidak memiliki rutinitas StartIo tidak dapat memanggil IoStartNextPacketByKey.

Penelepon IoStartNextPacketByKey harus berjalan di IRQL <= DISPATCH_LEVEL. Biasanya, rutinitas ini dipanggil dari rutinitas DpcForIsr atau CustomDpc driver perangkat, yang keduanya dijalankan di IRQL = DISPATCH_LEVEL.

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

Lihat juga

DEVICE_OBJECT

IoStartNextPacket

IoStartPacket