WdfWorkItemGetParentObject-Funktion (wdfworkitem.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfWorkItemGetParentObject-Methode gibt das Frameworkobjekt zurück, dem eine angegebene Arbeitsaufgabe zugeordnet ist.

Syntax

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Parameter

[in] WorkItem

Ein Handle für ein Framework-Arbeitselementobjekt, das aus einem vorherigen Aufruf von WdfWorkItemCreateabgerufen wird.

Rückgabewert

WdfWorkItemGetParentObject gibt ein Handle an das Frameworkobjekt zurück, das der Treiber als ParentObject Member der WDF_OBJECT_ATTRIBUTES Struktur des Treibers angegeben hat, wenn der Treiber zuvor WdfWorkItemCreateaufgerufen hat.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu Arbeitsaufgaben finden Sie unter Using Framework Work Items.

Beispiele

Das folgende Codebeispiel ist eine EvtWorkItem- Rückruffunktion aus dem 1394 Beispieltreiber. Das Beispiel ruft das übergeordnete Geräteobjekt einer Arbeitsaufgabe ab, ruft eine treiberdefinierte Routine zum Verarbeiten der Arbeitsaufgabe auf und löscht dann das Arbeitselementobjekt.

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

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfworkitem.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate

Freigeben über