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

Consulte también

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx