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

Consulte también

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG