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) |
関連項目
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT
WdfChildListEndIteration の
WdfChildListRetrieveNextDevice の