Fungsi IoStartNextPacketByKey (ntifs.h)

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

Sintaks

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

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat tempat IRP akan dibatalkan antreannya.

[in] Cancelable

Menentukan apakah IRP 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 ketika disebut IoStartPacket, driver harus meneruskan TRUE dalam parameter Yang Dapat Dibatalkan rutin ini. Jika Dapat Dibatalkan TRUE, 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 pada IRQL = DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000
Target Platform	Universal
Header	ntifs.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Lihat juga

DEVICE_OBJECT

IoStartNextPacket

IoStartPacket