WUDF_WORKITEM_FUNCTION función de devolución de llamada (wudfworkitem.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.
La función de devolución de llamada de eventos OnWorkItem de un controlador realiza el trabajo asociado a un elemento de trabajo especificado.
Sintaxis
WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;
void WudfWorkitemFunction(
[in] IWDFWorkItem *pWorkItem
)
{...}
Parámetros
[in] pWorkItem
Puntero a una interfaz IWDFWorkItem .
Valor devuelto
None
Observaciones
Para registrar una función de devolución de llamada OnWorkItem , el controlador debe colocar la dirección de la función de devolución de llamada en una estructura de WUDF_WORKITEM_CONFIG antes de llamar a IWDFDevice3::CreateWorkItem.
Normalmente, la función de devolución de llamada OnWorkItem de un controlador realiza tareas especificadas por información que el controlador almacena en la memoria de contexto de un objeto de elemento de trabajo.
El controlador no debe llamar a IWDFObject::D eleteWdfObject desde la función de devolución de llamada OnWorkItem .
Para obtener más información, consulte Uso de elementos de trabajo.
Ejemplos
El tipo de función se declara en Wudfworkitem.h, como se indica a continuación.
typedef
VOID
WUDF_WORKITEM_FUNCTION(
_In_
IWDFWorkItem* pWorkItem
);
typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;
Para definir una función de devolución de llamada OnWorkItem denominada MyWorkItem, primero debe proporcionar una declaración de función que requieren SDV y otras herramientas de comprobación, como se indica a continuación:
WUDF_WORKITEM_FUNCTION MyWorkItem;
A continuación, implemente la función de devolución de llamada de la siguiente manera:
VOID
MyWorkItem (
_In_
IWDFWorkItem* pWorkItem
)
{…}
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 | wudfworkitem.h |