Expand Minimize

WdfPdoGetParent method

[Applies to KMDF only]

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

Syntax


WDFDEVICE WdfPdoGetParent(
  [in]  WDFDEVICE Device
);

Parameters

Device [in]

A handle to a framework device object that represents the device's physical device object (PDO).

Return value

The method returns a handle to the framework device object that represents the specified device's parent, or NULL if the Device value does not represent a PDO.

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

Examples

The following code example obtains a handle to the framework device object that represents a specified device's parent device.


WDFDEVICE  parentDevice;

parentDevice = WdfPdoGetParent(device);

Requirements

Minimum KMDF version

1.0

Header

Wdfpdo.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.