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 |