IO_WORKITEM_ROUTINE_EX função de retorno de chamada (wdm.h)

Artigo
03/08/2023

Uma rotina WorkItemEx executa o processamento de um item de trabalho que foi enfileirado pela rotina IoQueueWorkItemEx ou 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 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 ou IoTryQueueWorkItem 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 IoQueueWorkItemEx ou IoTryQueueWorkItem quando o item de trabalho foi enfileirado.

[in] IoWorkItem

Ponteiro para a estrutura de IO_WORKITEM para o item de trabalho. Esse é o ponteiro que foi passado como o parâmetro IoWorkItem para IoQueueWorkItemEx ou IoTryQueueWorkItem.

Retornar valor

Nenhum

Comentários

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 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 uma rotina de retorno de chamada WorkItemEx , 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 gravar drivers para o sistema operacional Windows.

Por exemplo, para definir uma rotina de retorno de chamada WorkItemEx chamada 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 _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_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.