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