Método IWDFDevice3::CreateWorkItem (wudfddi.h)

Artigo
03/01/2024

[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. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método CreateWorkItem cria um objeto de item de trabalho da estrutura, que pode ser adicionado posteriormente à fila de itens de trabalho da estrutura.

Sintaxe

HRESULT CreateWorkItem(
  [in]           PWUDF_WORKITEM_CONFIG pConfig,
  [in, optional] IWDFObject            *pParentObject,
  [out]          IWDFWorkItem          **ppWorkItem
);

Parâmetros

[in] pConfig

Um ponteiro para uma estrutura de WUDF_WORKITEM_CONFIG alocada pelo chamador que o driver já deve ter inicializado chamando WUDF_WORKITEM_CONFIG_INIT.

[in, optional] pParentObject

Um ponteiro para a interface do objeto pai ou NULL.

[out] ppWorkItem

Um ponteiro para um buffer que recebe um ponteiro para a interface IWDFWorkItem para o novo objeto WorkItem.

Retornar valor

O método retornará S_OK se a operação for bem-sucedida. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.

Comentários

Se você especificar um objeto pai, a estrutura excluirá automaticamente o item de trabalho quando o objeto pai for excluído. Como alternativa, o driver pode chamar IWDFObject::D eleteWdfObject para excluir um item de trabalho. O driver não deve excluir um item de trabalho em sua função de retorno de chamada OnWorkItem .

Para obter mais informações, consulte Usando itens de trabalho.

Exemplos

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);

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	wudfddi.h
DLL	WUDFx.dll