WdfPdoAddEjectionRelationsPhysicalDevice 函数 (wdfpdo.h)
[仅适用于 KMDF]
WdfPdoAddEjectionRelationsPhysicalDevice 方法指示在弹出另一个指定设备时弹出指定的设备。
语法
NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
[in] WDFDEVICE Device,
[in] PDEVICE_OBJECT PhysicalDevice
);
参数
[in] Device
框架设备对象的句柄。
[in] PhysicalDevice
指向调用方提供的 DEVICE_OBJECT 结构的指针,该结构表示 (PDO) 的物理设备对象。
返回值
如果操作成功,该方法将返回STATUS_SUCCESS。 其他返回值包括:
返回代码 | 说明 |
---|---|
|
输入参数为 NULL。 |
|
内存分配失败。 |
方法还可能返回其他 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) |