IoAllocateWorkItem 函数 (wdm.h)

IoAllocateWorkItem 例程分配工作项。

语法

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

参数

[in] DeviceObject

指向调用方驱动程序对象的指针或调用方的设备对象之一。 如果调用方稍后会将工作项传递给 ioQueueWorkItem DeviceObject 必须指向设备对象。

返回值

IoAllocateWorkItem 返回指向分配 IO_WORKITEM 结构的指针。 如果没有足够的资源,则例程返回 NULL

言论

驱动程序必须通过调用 IoFreeWorkItem来释放 IoAllocateWorkItem 返回的工作项。

IoAllocateWorkItem 分配和初始化工作项。 相关例程(IoInitializeWorkItem)初始化驱动程序以前分配的存储中的工作项。 请勿调用 IoInitializeWorkItem 来初始化 由 ioAllocateWorkItem分配的工作项。

有关工作项的详细信息,请参阅 系统工作线程

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows作系统和 Windows Me 中提供。 此例程在 Windows 98 中不可用。
目标平台 普遍
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另请参阅

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx