通过

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
 PhysicalDeviceNULL。
STATUS_INSUFFICIENT_RESOURCES
 内存分配失败。
 

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

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

言论

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

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

例子

下面的代码示例将 pPdo 标识的设备列表，这些设备必须在删除 设备 指定的设备列表中。

status = WdfDeviceAddRemovalRelationsPhysicalDevice(
                                                    device,
                                                    pPdo
                                                    );

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdfdevice.h （包括 Wdf.h）
库 Wdf01000.sys（请参阅框架库版本控制。
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另请参阅

WdfDeviceClearRemovalRelationsDevices

WdfDeviceRemoveRemovalRelationsPhysicalDevice