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 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.]
La onWorkItem de un controlador función de devolución de llamada de eventos 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
Ninguno
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, el onWorkItem de un controlador función de devolución de llamada 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, vea Using Work Items.
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 un OnWorkItem función de devolución de llamada 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 | 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 | wudfworkitem.h |