Fonction IoAllocateWorkItem (wdm.h)
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 |