WdfDpcGetParentObject function (wdfdpc.h)

[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

See also

EvtDpcFunc