WdfDpcGetParentObject-Funktion (wdfdpc.h)

[Gilt nur für KMDF]

Die WdfDpcGetParentObject-Methode gibt das übergeordnete Objekt eines angegebenen DPC-Objekts zurück.

Syntax

WDFOBJECT WdfDpcGetParentObject(
  [in] WDFDPC Dpc
);

Parameter

[in] Dpc

Ein Handle für ein DPC-Frameworkobjekt.

Rückgabewert

WdfDpcGetParentObject gibt ein Handle an das übergeordnete Objekt eines angegebenen DPC-Objekts zurück.

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

Hinweise

Ein Treiber kann WdfDpcGetParentObject aus seiner EvtDpcFunc-Rückruffunktion aufrufen.

Beispiele

Im folgenden Codebeispiel wird ein Handle für das übergeordnete Objekt eines angegebenen DPC-Objekts zurückgegeben. Das WdfDpcCreate-Codebeispiel zeigt, wie das angegebene DPC-Objekt erstellt wurde.

WDFDEVICE Device;

Device = WdfDpcGetParentObject(PDevExt->CompleteWriteDpc);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdpc.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL Beliebige Ebene
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

EvtDpcFunc