WUDF_WORKITEM_FUNCTION função de retorno de chamada (wudfworkitem.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

A função de retorno de chamada de evento OnWorkItem de um 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 .

Retornar valor

Nenhum

Comentários

Para registrar uma função de retorno de chamada OnWorkItem , o driver deve colocar o endereço da função de retorno de chamada em uma estrutura WUDF_WORKITEM_CONFIG antes de chamar IWDFDevice3::CreateWorkItem.

Normalmente, a função de retorno de chamada OnWorkItem de um 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 chamada 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 a 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.
Plataforma de Destino	Área de Trabalho
Versão mínima do UMDF	1.11
Cabeçalho	wudfworkitem.h

Confira também

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG