WdfChildListBeginScan 函式 (wdfchildlist.h)
[僅適用於 KMDF]
WdfChildListBeginScan 方法會準備指定的子裝置清單，讓驅動程式可以更新清單中的資訊。
語法
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
參數
[in] ChildList
架構子清單物件的句柄。
傳回值
無
備註
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
WdfChildListBeginScan 方法會將清單中的所有子裝置標示為遺漏。
呼叫 WdfChildListBeginScan 之後，驅動程式可以重複呼叫 WdfChildListAddOrUpdateChildDescriptionAsPresent ，或呼叫 WdfChildListUpdateAllChildDescriptionsAsPresent 來報告目前附加至父裝置的所有子裝置。
驅動程式完成更新子清單之後，它必須呼叫 WdfChildListEndScan。 此呼叫會將更新的子清單傳遞給 隨插即用 (PnP) 管理員。 接著，架構會針對驅動程序回報的每個裝置呼叫驅動程式的 EvtChildListCreateDevice 回呼函式。
如需子清單的詳細資訊，請參閱 動態列舉。
範例
如需使用 WdfChildListBeginScan 的程式代碼範例，請參閱 WdfChildListAddOrUpdateChildDescriptionAsPresent。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 標頭 | wdfchildlist.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |