Função IoAllocateWorkItem (wdm.h)

  • Artigo

A rotina IoAllocateWorkItem aloca um item de trabalho.

Sintaxe

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto de driver do chamador ou para um dos objetos de dispositivo do chamador. Se o chamador passar posteriormente o item de trabalho para IoQueueWorkItem, DeviceObject deverá apontar para um objeto de dispositivo.

Retornar valor

IoAllocateWorkItem retorna um ponteiro para a estrutura de IO_WORKITEM alocada. A rotina retornará NULL se recursos suficientes não existirem.

Comentários

O driver deve liberar o item de trabalho retornado por IoAllocateWorkItem chamando IoFreeWorkItem.

IoAllocateWorkItem aloca e inicializa um item de trabalho. Uma rotina relacionada, IoInitializeWorkItem, inicializa um item de trabalho no armazenamento que o driver alocou anteriormente. Não chame IoInitializeWorkItem para inicializar um item de trabalho alocado por IoAllocateWorkItem.

Para obter mais informações sobre itens de trabalho, consulte Threads do System Worker.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do sistema operacional Windows e no Windows Me. Essa rotina não está disponível no Windows 98.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Confira também

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx