IO_WORKITEM_ROUTINE função de retorno de chamada (wdm.h)
Uma rotina WorkItem executa o processamento de um item de trabalho que foi enfileirado pela rotina IoQueueWorkItem .
Sintaxe
IO_WORKITEM_ROUTINE IoWorkitemRoutine;
void IoWorkitemRoutine(
[in] PDEVICE_OBJECT DeviceObject,
[in, optional] PVOID Context
)
{...}
Parâmetros
[in] DeviceObject
Ponteiro para um dos objetos de dispositivo do chamador. Esse é o ponteiro que foi passado como o parâmetro DeviceObject para IoAllocateWorkItem quando o item de trabalho foi alocado ou como o parâmetro IoObject para IoInitializeWorkItem quando o item de trabalho foi inicializado.
[in, optional] Context
Especifica informações de contexto específicas do driver. Esse é o valor que foi passado como o parâmetro Context para IoQueueWorkItem quando o item de trabalho foi enfileirado.
Retornar valor
Nenhum
Comentários
O driver enfileira uma rotina WorkItem chamando IoQueueWorkItem e um thread de trabalho do sistema executa a rotina posteriormente. Uma rotina WorkItem deve ser executada por um período limitado de tempo; caso contrário, o sistema poderá fazer deadlock. Para obter mais informações, consulte System Worker Threads.
Uma rotina WorkItem é executada em IRQL = PASSIVE_LEVEL e em um contexto de thread do sistema.
Exemplos
Para definir uma rotina de retorno de chamada workitem , primeiro você deve fornecer uma declaração de função que identifique o tipo de rotina de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.
Por exemplo, para definir uma rotina de retorno de chamada WorkItem chamada MyWorkItem, use o tipo IO_WORKITEM_ROUTINE conforme mostrado neste exemplo de código:
IO_WORKITEM_ROUTINE MyWorkItem;
Em seguida, implemente sua rotina de retorno de chamada da seguinte maneira:
_Use_decl_annotations_
VOID
MyWorkItem(
PDEVICE_OBJECT DeviceObject,
PVOID Context
)
{
// Function body
}
O tipo de função IO_WORKITEM_ROUTINE é definido no arquivo de cabeçalho Wdm.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a _Use_decl_annotations_ anotação à sua definição de função. A _Use_decl_annotations_ anotação garante que as anotações aplicadas ao tipo de função IO_WORKITEM_ROUTINE no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers WDM. Para obter informações sobre _Use_decl_annotations_, consulte Anotando o comportamento da função.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | Chamado em PASSIVE_LEVEL. |