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

Vedi anche

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx