Edit

WdfDpcGetParentObject function (wdfdpc.h)

  • Article

[Applies to KMDF only]

The WdfDpcGetParentObject method returns the parent object of a specified DPC object.

Syntax

WDFOBJECT WdfDpcGetParentObject(
  [in] WDFDPC Dpc
);

Parameters

[in] Dpc

A handle to a framework DPC object.

Return value

WdfDpcGetParentObject returns a handle to the parent object of a specified DPC object.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

A driver might call WdfDpcGetParentObject from within its EvtDpcFunc callback function.

Examples

The following code example returns a handle to the parent object of a specified DPC object. The WdfDpcCreate code example shows how the specified DPC object was created.

WDFDEVICE Device;

Device = WdfDpcGetParentObject(PDevExt->CompleteWriteDpc);

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfdpc.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL Any level
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

EvtDpcFunc