WdfPdoRemoveEjectionRelationsPhysicalDevice function

[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(
  WDFDEVICE      Device,
  PDEVICE_OBJECT PhysicalDevice
);

Parameters

Device

A handle to a framework device object.

PhysicalDevice

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

Return Value

None.

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

Remarks

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

   
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, KmdfIrql, KmdfIrql2

See Also

WdfPdoAddEjectionRelationsPhysicalDevice

WdfPdoClearEjectionRelationsDevices