WUDF_WORKITEM_FUNCTION função de retorno de chamada (wudfworkitem.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
A função de retorno de chamada de evento OnWorkItem do driver executa o trabalho associado a um item de trabalho especificado.
Sintaxe
WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;
void WudfWorkitemFunction(
[in] IWDFWorkItem *pWorkItem
)
{...}
Parâmetros
[in] pWorkItem
Um ponteiro para uma interface IWDFWorkItem.
Valor de retorno
Nenhum
Observações
Para registrar uma função de retorno de chamada do OnWorkItem, o driver deve colocar o endereço da função de retorno de chamada em uma estrutura de WUDF_WORKITEM_CONFIG antes de chamar IWDFDevice3::CreateWorkItem.
Normalmente, a função de retorno de chamada OnWorkItem do driver executa tarefas especificadas por informações que o driver armazenou na memória de contexto de um objeto de item de trabalho.
O driver não deve chamar IWDFObject::D eleteWdfObject da função de retorno de chamada OnWorkItem.
Para obter mais informações, consulte Usando itens de trabalho.
Exemplos
O tipo de função é declarado em Wudfworkitem.h, da seguinte maneira.
typedef
VOID
WUDF_WORKITEM_FUNCTION(
_In_
IWDFWorkItem* pWorkItem
);
typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;
Para definir uma função de retorno de chamada OnWorkItem denominada MyWorkItem, primeiro você deve fornecer uma declaração de função que o SDV e outras ferramentas de verificação exigem, da seguinte maneira:
WUDF_WORKITEM_FUNCTION MyWorkItem;
Em seguida, implemente sua função de retorno de chamada da seguinte maneira:
VOID
MyWorkItem (
_In_
IWDFWorkItem* pWorkItem
)
{…}
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.11 |
| cabeçalho | wudfworkitem.h |