WdfPdoAddEjectionRelationsPhysicalDevice 函数 (wdfpdo.h)

  • 项目

[仅适用于 KMDF]

WdfPdoAddEjectionRelationsPhysicalDevice 方法指示在弹出另一个指定设备时弹出指定的设备。

语法

NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

参数

[in] Device

框架设备对象的句柄。

[in] PhysicalDevice

指向调用方提供的 DEVICE_OBJECT 结构的指针，该结构表示 (PDO) 的物理设备对象。

返回值

如果操作成功，该方法将返回STATUS_SUCCESS。 其他返回值包括：

返回代码 说明
STATUS_INVALID_PARAMETER
 输入参数为 NULL。
STATUS_INSUFFICIENT_RESOURCES
 内存分配失败。
 

方法还可能返回其他 NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生系统 bug 检查。

注解

PhysicalDevice 参数指向在弹出 Device 标识的设备时弹出的设备的 PDO。 通常，这两个设备都由调用驱动程序控制。 请勿报告 设备的 子设备，因为当 PnP 管理器弹出父设备时，也会弹出设备的子设备。

有关详细信息，请参阅 支持可弹出的设备。

示例

下面的代码示例将 pPhysicalDeviceObject 结构表示的设备添加到设备列表中，这些设备在 设备 指定的设备弹出时弹出。

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

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfpdo.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库版本控制.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WdfPdoClearEjectionRelationsDevices

WdfPdoRemoveEjectionRelationsPhysicalDevice