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 检查。

注解

总线驱动程序可以调用 WdfChildListRequestChildEjectWdfPdoRequestEject 来报告驱动程序检测到尝试从设备的停靠站弹出其中一个枚举子设备。 例如,驱动程序可能会检测到用户已推送弹出按钮。

如果驱动程序使用的是动态总线枚举,并且设备的标识说明可用,驱动程序可以调用 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