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

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método CreateWorkItem crea un objeto de elemento de trabajo de marco, que posteriormente se puede agregar a la cola de elementos de trabajo del marco.

Sintaxis

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

Parámetros

[in] pConfig

Puntero a una estructura de WUDF_WORKITEM_CONFIG asignada por el autor de la llamada que el controlador debe haber inicializado llamando a WUDF_WORKITEM_CONFIG_INIT.

[in, optional] pParentObject

Puntero a la interfaz de objeto principal o NULL.

[out] ppWorkItem

Puntero a un búfer que recibe un puntero a la interfaz IWDFWorkItem del nuevo objeto WorkItem.

Valor devuelto

El método devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Comentarios

Si especifica un objeto primario, el marco elimina automáticamente el elemento de trabajo cuando se elimina el objeto primario. Como alternativa, el controlador puede llamar a IWDFObject::D eleteWdfObject para eliminar un elemento de trabajo. El controlador no debe eliminar un elemento de trabajo en su función de devolución de llamada OnWorkItem .

Para obtener más información, consulte Uso de elementos de trabajo.

Ejemplos

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

Requisitos

Consulte también

IWDFDevice3

IWDFWorkItem

OnWorkItem

WUDF_WORKITEM_CONFIG

WUDF_WORKITEM_CONFIG_INIT