Función IoAllocateWorkItem (wdm.h)
La rutina IoAllocateWorkItem asigna un elemento de trabajo.
Sintaxis
PIO_WORKITEM IoAllocateWorkItem(
[in] PDEVICE_OBJECT DeviceObject
);
Parámetros
[in] DeviceObject
Puntero al objeto de controlador del autor de la llamada o a uno de los objetos de dispositivo del autor de la llamada. Si el autor de la llamada pasará más adelante el elemento de trabajo a IoQueueWorkItem, DeviceObject debe apuntar a un objeto de dispositivo.
Valor devuelto
IoAllocateWorkItem devuelve un puntero a la estructura de IO_WORKITEM asignada. La rutina devuelve NULL si no existen recursos suficientes.
Comentarios
El controlador debe liberar el elemento de trabajo devuelto por IoAllocateWorkItem llamando a IoFreeWorkItem.
IoAllocateWorkItem asigna e inicializa un elemento de trabajo. Una rutina relacionada, IoInitializeWorkItem, inicializa un elemento de trabajo en el almacenamiento que el controlador ha asignado anteriormente. No llame a IoInitializeWorkItem para inicializar un elemento de trabajo asignado por IoAllocateWorkItem.
Para obtener más información sobre los elementos de trabajo, vea Subprocesos de trabajo del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores del sistema operativo Windows y en Windows Me. Esta rutina no está disponible en Windows 98. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |