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

Artículo
02/27/2024

[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

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.11
Encabezado	wudfddi.h
Archivo DLL	WUDFx.dll