Función WdfWorkItemGetParentObject (wdfworkitem.h)

[Se aplica a KMDF y UMDF]

El método WdfWorkItemGetParentObject devuelve el objeto de marco al que está asociado un elemento de trabajo especificado.

Sintaxis

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Parámetros

[in] WorkItem

Identificador de un objeto de elemento de trabajo de marco que se obtiene de una llamada anterior a WdfWorkItemCreate.

Valor devuelto

WdfWorkItemGetParentObject devuelve un identificador al objeto de marco que el controlador especificó como miembro ParentObject de la estructura de WDF_OBJECT_ATTRIBUTES del controlador cuando el controlador llamó anteriormente a WdfWorkItemCreate.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Para obtener más información sobre los elementos de trabajo, vea Uso de elementos de trabajo de framework.

Ejemplos

El ejemplo de código siguiente es una función de devolución de llamada EvtWorkItem del controlador de ejemplo 1394 . En el ejemplo se obtiene el objeto de dispositivo primario de un elemento de trabajo, se llama a una rutina definida por el controlador para procesar el elemento de trabajo y, a continuación, se elimina el objeto de elemento de trabajo.

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfworkitem.h (incluya Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate