WdfChildListBeginScan 函数 (wdfchildlist.h)
[仅适用于 KMDF]
WdfChildListBeginScan 方法准备子设备的指定列表，以便驱动程序可以更新列表中的信息。
语法
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
参数
[in] ChildList
框架子列表对象的句柄。
返回值
无
备注
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
WdfChildListBeginScan 方法将列表中的所有子设备标记为缺失。
调用 WdfChildListBeginScan 后，驱动程序可以重复调用 WdfChildListAddOrUpdateChildDescriptionAsPresent ，或调用 WdfChildListUpdateAllChildDescriptionsAsPresent，以报告当前附加到父设备的所有子设备。
驱动程序完成子列表更新后，必须调用 WdfChildListEndScan。 此调用将更新的子列表传递给即插即用 (PnP) 管理器。 随后，框架将为驱动程序报告的每个设备调用驱动程序的 EvtChildListCreateDevice 回调函数。
有关子列表的详细信息，请参阅 动态枚举。
示例
有关使用 WdfChildListBeginScan 的代码示例，请参阅 WdfChildListAddOrUpdateChildDescriptionAsPresent。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfchildlist.h (包括 Wdf.h) |
| Library | Wdf01000.sys (请参阅框架库版本控制.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |