EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN回调函数 (wdfchildlist.h)

  • 项目

[仅适用于 KMDF]

驱动程序的 EvtChildListScanForChildren 事件回调函数必须报告存在的所有子设备。

语法

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

参数

[in] ChildList

框架子列表对象的句柄。

返回值

无

备注

如果总线驱动程序使用动态枚举，则可以通过调用 WdfFdoInitSetDefaultChildListConfig 或 WdfChildListCreate 来注册 EvtChildListScanForChildren 回调函数。

如果驱动程序提供 EvtChildListScanForChildren 回调函数，则每当父设备进入其工作 (D0) 状态时，框架都会调用它。 (有关何时调用此回调函数的详细信息，请参阅 PnP 和电源管理方案。)

驱动程序必须通过执行以下操作来报告其所有子设备：

  1. 调用 WdfChildListBeginScan，将以前报告的所有子设备标记为缺失。
  2. 检测子设备并为每个检测到的设备调用 WdfChildListAddOrUpdateChildDescriptionAsPresent 。
  3. 调用 WdfChildListEndScan，这会通知 PnP 管理员报告的子设备。
有关动态枚举的详细信息，请参阅 枚举总线上的设备。

EvtChildListScanForChildren 回调函数在 IRQL = PASSIVE_LEVEL调用。 不应使此回调函数 可分页。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfchildlist.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL (请参阅备注部分)

另请参阅

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig