WdfPdoRemoveEjectionRelationsPhysicalDevice function (wdfpdo.h)

[Applies to KMDF only]

The WdfPdoRemoveEjectionRelationsPhysicalDevice method removes a specified device from the list of devices that must be ejected when another specified device is ejected.

Syntax

void WdfPdoRemoveEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

Parameters

[in] Device

A handle to a framework device object.

[in] PhysicalDevice

A pointer to a caller-supplied DEVICE_OBJECT structure that represents a physical device object (PDO).

Return value

None

Remarks

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

The PhysicalDevice parameter points to a PDO of a device that WdfPdoRemoveEjectionRelationsPhysicalDevice removes from the list of devices that must be ejected when the device represented by the Device parameter is ejected.

For more information, see Supporting Ejectable Devices.

Examples

The following code example removes the device that the pPhysicalDeviceObject structure represents from the list of devices that are ejected when the device that device specifies is ejected.

PDEVICE_OBJECT  pPhysicalDeviceObject;
NTSTATUS  status;
...
status = WdfPdoRemoveEjectionRelationsPhysicalDevice(
                                                     device,
                                                     pPhysicalDeviceObject
                                                     );

Requirements

Requirement Value
Target Platform Universal
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(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WdfPdoAddEjectionRelationsPhysicalDevice

WdfPdoClearEjectionRelationsDevices