WdfDpcGetParentObject method

[Applies to KMDF only]

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

Syntax


WDFOBJECT WdfDpcGetParentObject(
  [in]  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

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

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft