共用方式為


(wdm.h) IoAllocateWorkItem 函式

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。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx