WdfPdoRemoveEjectionRelationsPhysicalDevice function (wdfpdo.h)

Artikel
04/18/2022

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

Delen via