WdfDeviceAddRemovalRelationsPhysicalDevice 函数 (wdfdevice.h)

  • 项目

[仅适用于 KMDF]

WdfDeviceAddRemovalRelationsPhysicalDevice 方法指示在删除另一个指定设备时必须删除指定的设备。

语法

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

参数

[in] Device

框架设备对象的句柄。

[in] PhysicalDevice

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

返回值

如果操作成功， WdfDeviceAddRemovalRelationsPhysicalDevice 返回STATUS_SUCCESS。 其他返回值包括：

返回代码 说明
STATUS_INVALID_PARAMETER
 PhysicalDevice 为 NULL。
STATUS_INSUFFICIENT_RESOURCES
 内存分配失败。
 

该方法可能会返回其他 NTSTATUS 值。

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

注解

PhysicalDevice 参数指向设备的 PDO，当删除 Device 的驱动程序时，必须删除该设备的驱动程序。 通常，这两个设备都由调用驱动程序控制。 不要报告 Device 中指定的设备对象的子设备，因为当即插即用管理器删除父设备时，也会删除设备的子设备。

驱动程序可以多次调用 WdfDeviceAddRemovalRelationsPhysicalDevice ，将多个设备添加到删除 设备 时必须删除的设备列表中。 未定义删除指定设备的顺序。

示例

下面的代码示例将 pPdo 标识的设备添加到删除设备指定的设备时必须删除 的设备 列表。

status = WdfDeviceAddRemovalRelationsPhysicalDevice(
                                                    device,
                                                    pPdo
                                                    );

要求

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

另请参阅

WdfDeviceClearRemovalRelationsDevices

WdfDeviceRemoveRemovalRelationsPhysicalDevice