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 de 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 de Contexto para IoQueueWorkItem quando o item de trabalho foi enfileirado.
Valor de retorno
Nenhum
Observações
O driver enfileira uma rotina WorkItem chamando IoQueueWorkIteme um thread de trabalho do sistema executa a rotina posteriormente. Uma rotina workitem deve ser executada por um período limitado; 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 um WorkItem rotina de retorno de chamada, 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 encontram erros e é um requisito para gravar drivers para o sistema operacional Windows.
Por exemplo, para definir um workitem rotina de retorno de chamada denominada 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 anotação _Use_decl_annotations_ à sua definição de função. A anotação _Use_decl_annotations_ 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | Chamado no PASSIVE_LEVEL. |