ioStartPacket 函数 (ntifs.h)

项目
02/27/2024

IoStartPacket 例程使用给定的 IRP 调用驱动程序的 StartIo 例程，或者将 IRP 插入到与给定设备对象关联的设备队列中（如果设备已经繁忙）。

语法

void IoStartPacket(
  [in]           PDEVICE_OBJECT DeviceObject,
  [in]           PIRP           Irp,
  [in, optional] PULONG         Key,
  [in, optional] PDRIVER_CANCEL CancelFunction
);

参数

[in] DeviceObject

指向 IRP 的目标设备对象的指针。

[in] Irp

指向要处理的 IRP 的指针。

[in, optional] Key

指向一个值的指针，该值确定将数据包插入设备队列的位置。如果为零，则数据包将插入到设备队列的末尾。

[in, optional] CancelFunction

指定驱动程序提供的 Cancel 例程的入口点。

返回值

无

备注

如果驱动程序已忙于处理目标设备对象的请求，则数据包在设备队列中排队。否则，此例程使用指定的 IRP 调用驱动程序的 StartIo 例程。

如果提供了非 NULL CancelFunction 指针，则会在 IRP 中设置该指针，以便在 IRP 完成之前取消该 IRP 时调用驱动程序的 Cancel 例程。

没有 StartIo 例程的驱动程序无法调用 IoStartPacket。

IoStartPacket 的调用方必须在 IRQL <= DISPATCH_LEVEL运行。通常，此例程从设备驱动程序的 Dispatch 例程（IRQL = PASSIVE_LEVEL）调用。

要求

要求	值
最低受支持的客户端	Windows 2000
目标平台	通用
标头	ntifs.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (请参阅备注部分)