Funzione IoAllocateWorkItem (wdm.h)

Articolo
02/29/2024

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