IO_WORKITEM_ROUTINE_EX função de retorno de chamada (wdm.h)
Uma rotina WorkItemEx executa o processamento de um item de trabalho que foi enfileirado pelo IoQueueWorkItemEx ou rotina de IoTryQueueWorkItem.
Sintaxe
IO_WORKITEM_ROUTINE_EX IoWorkitemRoutineEx;
void IoWorkitemRoutineEx(
[in] PVOID IoObject,
[in, optional] PVOID Context,
[in] PIO_WORKITEM IoWorkItem
)
{...}
Parâmetros
[in] IoObject
Ponteiro para o objeto de driver do chamador ou para um dos objetos do dispositivo do chamador. Esse é o ponteiro passado como o parâmetro DeviceObject para IoAllocateWorkItem quando o item de trabalho foi alocado ou como o parâmetro IoObject para IoInitializeWorkItem ou IoTryQueueWorkItem quando o item de trabalho foi inicializado.
[in, optional] Context
Especifica informações de contexto específicas do driver. Esse é o valor passado como o parâmetro Context para IoQueueWorkItemEx ou IoTryQueueWorkItem quando o item de trabalho foi enfileirado.
[in] IoWorkItem
Ponteiro para a estrutura IO_WORKITEM para o item de trabalho. Esse é o ponteiro passado como o parâmetro IoWorkItem para IoQueueWorkItemEx ou IoTryQueueWorkItem.
Valor de retorno
Nenhum
Observações
Os drivers podem implementar rotinas WorkItemEx somente no Windows Vista e versões posteriores do Windows.
O driver enfileira uma rotina WorkItemEx chamando IoQueueWorkItemEx ou IoTryQueueWorkItem e um thread de trabalho do sistema executa a rotina posteriormente. Para obter mais informações, consulte System Worker Threads.
Uma rotina de WorkItemEx 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 WorkItemEx é executada em IRQL = PASSIVE_LEVEL e em um contexto de thread do sistema.
Exemplos
Para definir um WorkItemEx 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 WorkItemEx rotina de retorno de chamada denominada MyWorkItemEx, use o tipo IO_WORKITEM_ROUTINE_EX conforme mostrado neste exemplo de código:
IO_WORKITEM_ROUTINE_EX MyWorkItemEx;
Em seguida, implemente sua rotina de retorno de chamada da seguinte maneira:
_Use_decl_annotations_
VOID
MyWorkItemEx(
PVOID IoObject,
PVOID Context,
PIO_WORKITEM IoWorkItem
)
{
// Function body
}
O tipo de função IO_WORKITEM_ROUTINE_EX é 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_EX 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. |