Método IWDFDevice3::CreateWorkItem (wudfddi.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 .]
O método CreateWorkItem cria um objeto de item de trabalho da estrutura, que pode ser adicionado posteriormente à fila de item 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 de objeto pai ou NULL.
[out] ppWorkItem
Um ponteiro para um buffer que recebe um ponteiro para a interface IWDFWorkItem para o novo objeto WorkItem.
Valor de retorno
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.
Observações
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. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.11 |
| cabeçalho | wudfddi.h |
| de DLL | WUDFx.dll |