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 nuevos controladores UMDF deben escribirse mediante 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 a 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 al IWDFWorkItem interfaz para el 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.
Observaciones
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 OnWorkItem función de devolución de llamada.
Para obtener más información, vea Using Work Items.
Ejemplos
WUDF_WORKITEM_CONFIG config;
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem);
hr = m_IWdfDevice3->CreateWorkItem(&config,
m_IWdfDevice3,
&m_WorkItem);
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.11 |
| encabezado de | wudfddi.h |
| DLL de | WUDFx.dll |