WdfWorkItemGetParentObject-Funktion (wdfworkitem.h)

Artikel
02/29/2024

[Gilt für KMDF und UMDF]

Die WdfWorkItemGetParentObject-Methode gibt das Frameworkobjekt zurück, dem ein angegebenes Arbeitselement zugeordnet ist.

Syntax

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Parameter

[in] WorkItem

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

Rückgabewert

WdfWorkItemGetParentObject gibt ein Handle für das Frameworkobjekt zurück, das der Treiber als ParentObject-Member der WDF_OBJECT_ATTRIBUTES-Struktur des Treibers angegeben hat, wenn der Treiber zuvor WdfWorkItemCreate aufgerufen hat.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Weitere Informationen zu Arbeitselementen finden Sie unter Verwenden von Framework-Arbeitselementen.

Beispiele

Das folgende Codebeispiel ist eine EvtWorkItem-Rückruffunktion aus dem Beispieltreiber 1394 . Das Beispiel ruft das übergeordnete Geräteobjekt eines Arbeitselements ab, ruft eine vom Treiber definierte Routine auf, um das Arbeitselement zu verarbeiten, 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	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfworkitem.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate

Freigeben über