Funzione IoAllocateWorkItem (wdm.h)
La routine IoAllocateWorkItem alloca un elemento di lavoro.
Sintassi
PIO_WORKITEM IoAllocateWorkItem(
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[in] DeviceObject
Puntatore all'oggetto driver del chiamante o a uno degli oggetti dispositivo del chiamante. Se il chiamante passerà successivamente l'elemento di lavoro a IoQueueWorkItem, DeviceObject deve puntare a un oggetto dispositivo.
Valore restituito
IoAllocateWorkItem restituisce un puntatore alla struttura IO_WORKITEM allocata. La routine restituisce NULL se non esistono risorse sufficienti.
Commenti
Il driver deve liberare l'elemento di lavoro restituito da IoAllocateWorkItem chiamando IoFreeWorkItem.
IoAllocateWorkItem alloca e inizializza un elemento di lavoro. Una routine correlata , IoInitializeWorkItem, inizializza un elemento di lavoro nell'archiviazione allocato in precedenza dal driver. Non chiamare IoInitializeWorkItem per inizializzare un elemento di lavoro allocato da IoAllocateWorkItem.
Per altre informazioni sugli elementi di lavoro, vedere Thread di lavoro di sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive del sistema operativo Windows e in Windows Me. Questa routine non è disponibile in Windows 98. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |