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 do dispositivo do chamador. Se o chamador passar posteriormente o item de trabalho para IoQueueWorkItem, deviceObject deverá apontar para um objeto de dispositivo.
Valor de retorno
IoAllocateWorkItem retorna um ponteiro para a estrutura de IO_WORKITEM alocada. A rotina retornará NULL se recursos suficientes não existirem.
Observações
O driver deve liberar o item de trabalho retornado pelo 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 que foi alocado pelo IoAllocateWorkItem.
Para obter mais informações sobre itens de trabalho, consulte System Worker Threads.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | 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. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |