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）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL