共用方式為


IoAllocateWorkItem 函式 (wdm.h)

IoAllocateWorkItem 例程會配置工作專案。

語法

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

參數

[in] DeviceObject

呼叫端驅動程式物件的指標或呼叫端的其中一個裝置物件。 如果呼叫者稍後會將工作項目傳遞至 ioQueueWorkItem DeviceObject 必須指向裝置物件。

傳回值

IoAllocateWorkItem 會傳回配置之 IO_WORKITEM 結構的指標。 如果沒有足夠的資源不存在,則例程會傳回 NULL

言論

驅動程式必須呼叫 ioFreeWorkItem 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