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。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 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) |