WdfDpcGetParentObject function (wdfdpc.h)

[Applies to KMDF only]

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

Syntax

WDFOBJECT WdfDpcGetParentObject(
  WDFDPC Dpc
);

Parameters

Dpc

[in] 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

   
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, KmdfIrql, KmdfIrql2

See also

EvtDpcFunc