WdfChildListRequestChildEject 函数 (wdfchildlist.h)

  • 项目

[仅适用于 KMDF]

WdfChildListRequestChildEject 方法通知框架指定设备即将从其扩展坞中弹出。

语法

BOOLEAN WdfChildListRequestChildEject(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

参数

[in] ChildList

子列表对象的句柄。

[in] IdentificationDescription

指向调用方分配 的WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构的指针。

返回值

如果操作成功，WdfChildListRequestChildEject 将返回 TRUE。 如果输入参数无效，或者框架在子列表中找不到设备，则 该方法返回 FALSE。

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

注解

总线驱动程序可以调用 WdfChildListRequestChildEject 或 WdfPdoRequestEject ，以报告驱动程序已检测到尝试从设备的扩展坞弹出其枚举子设备之一。 例如，驱动程序可能会检测到用户按下了弹出按钮。

如果驱动程序使用动态总线枚举，并且设备的标识说明可用，则驱动程序可以调用 WdfChildListRequestChildEject。 如果设备的 PDO 的框架设备对象可用，驱动程序可以调用 WdfPdoRequestEject。

WdfChildListRequestChildEject 方法的 IdentificationDescription 参数标识要弹出的设备。 设备必须是 ChildList 参数表示的子列表的成员。

框架使用标识说明在子列表中查找设备。

有关子列表的详细信息，请参阅 动态枚举。

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

示例

有关使用 WdfChildListRequestChildEject 的代码示例，请参阅 WdfChildListRetrieveNextDevice。

要求

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

另请参阅

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject