Función IoAllocateWorkItem (wdm.h)

  • Artículo

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

Consulte también

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx