WdfChildListBeginIteration 函式 （wdfchildlist.h）
[僅適用於 KMDF]
WdfChildListBeginIteration 方法會準備架構，以從指定的子清單中擷取專案。
語法
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
參數
[in] ChildList
架構子清單物件的句柄。
[in] Iterator
呼叫端配置的 WDF_CHILD_LIST_ITERATOR 結構的指標，表示要擷取的子裝置類型。
傳回值
沒有
言論
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
呼叫 WdfChildListBeginIteration之後，驅動程式可以重複呼叫 WdfChildListRetrieveNextDevice，以取得子清單中每個子裝置的相關信息。
驅動程式完成呼叫 WdfChildListRetrieveNextDevice之後，它必須呼叫 WdfChildListEndIteration。
如果驅動程式在呼叫 WdfChildListBeginIteration之後變更子清單，架構會儲存所有變更，並在驅動程式呼叫 WdfChildListEndIteration 時通知變更的隨插即用 （PnP） 管理員。
驅動程式可以巢狀呼叫 WdfChildListBeginIteration 和 WdfChildListEndIteration。 如果驅動程式巢狀呼叫這些方法，架構會儲存所有變更，直到最後一次呼叫 WdfChildListEndIteration 為止。
如需子清單的詳細資訊，請參閱 動態列舉。
例子
如需使用 WdfChildListBeginIteration的程式代碼範例，請參閱 WdfChildListRetrieveNextDevice。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfchildlist.h （包括 Wdf.h） |
| 連結庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |