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 de pilote de l’appelant ou vers l’un des objets d’appareil de l’appelant. Si l’appelant passe ultérieurement l’élément de travail à IoQueueWorkItem, DeviceObject doit pointer vers un objet d’appareil.
Valeur de retour
IoAllocateWorkItem retourne un pointeur vers la structure 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 alloué par IoAllocateWorkItem.
Pour plus d’informations sur les éléments de travail, consultez threads de travail système.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |