(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 |