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 |