(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