Fonction IoAllocateWorkItem (wdm.h)

Article
02/27/2024

La routine IoAllocateWorkItem alloue un élément de travail.

Syntaxe

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet pilote de l’appelant ou vers l’un des objets d’appareil de l’appelant. Si l’appelant transmet ultérieurement l’élément de travail à IoQueueWorkItem, DeviceObject doit pointer vers un objet d’appareil.

Valeur retournée

IoAllocateWorkItem retourne un pointeur vers la structure de IO_WORKITEM allouée. La routine retourne null si des ressources suffisantes n’existent pas.

Remarques

Le pilote doit libérer l’élément de travail retourné par IoAllocateWorkItem en appelant IoFreeWorkItem.

IoAllocateWorkItem alloue et initialise un élément de travail. Une routine associée, IoInitializeWorkItem, initialise un élément de travail dans le stockage que le pilote a précédemment alloué. N’appelez pas IoInitializeWorkItem pour initialiser un élément de travail qui a été alloué par IoAllocateWorkItem.

Pour plus d’informations sur les éléments de travail, consultez Threads de travail système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures du système d’exploitation Windows et dans Windows Me. Cette routine n’est pas disponible dans Windows 98.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Voir aussi