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á posteriormente 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.
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores del sistema operativo Windows y en Windows Me. Esta rutina no está disponible en Windows 98. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL |