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 |