Função IoAllocateWorkItem (wdm.h)
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 |