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)