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 el miembro ParentObject de la estructura 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.
Observaciones
Para obtener más información sobre los elementos de trabajo, vea Using Framework Work Items.
Ejemplos
El ejemplo de código siguiente es una función de devolución de llamada EvtWorkItem del controlador de ejemplo de 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfworkitem.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |