Freigeben über


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
);

Die Parameter

[in] Dpc

Ein Handle zu einem Framework-DPC-Objekt.

Rückgabewert

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

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

Bemerkungen

Ein Treiber ruft möglicherweise WdfDpcGetParentObject innerhalb seiner EvtDpcFunc- Rückruffunktion auf.

Beispiele

Im folgenden Codebeispiel wird ein Handle an 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
Minimale KMDF-Version 1.0
Kopfzeile wdfdpc.h (enthalten Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL Beliebige Ebene
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

EvtDpcFunc