Edit

WdfChildListGetDevice function (wdfchildlist.h)

  • Article

[Applies to KMDF only]

The WdfChildListGetDevice method returns a handle to the framework device object that represents the parent device of a specified child list.

Syntax

WDFDEVICE WdfChildListGetDevice(
  [in] WDFCHILDLIST ChildList
);

Parameters

[in] ChildList

A handle to a framework child-list object.

Return value

WdfChildListGetDevice returns a handle to a framework device object.

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

Remarks

For more information about child lists, see Dynamic Enumeration.

Examples

The following code example obtains a handle to the device object that represents the parent device of a child list.

WDFDEVICE parentDevice;

parentDevice = WdfChildListGetDevice(ChildList);

Requirements

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