WdfChildListBeginScan 関数 (wdfchildlist.h)

[KMDF にのみ適用]

WdfChildListBeginScan メソッドは、ドライバーがリスト内の情報を更新できるように、指定された子デバイスの一覧を準備します。

構文

void WdfChildListBeginScan(
  [in] WDFCHILDLIST ChildList
);

パラメーター

[in] ChildList

フレームワークの子リスト オブジェクトへのハンドル。

戻り値

なし

解説

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

WdfChildListBeginScan メソッドは、リスト内のすべての子デバイスを見つからないものとしてマークします。

WdfChildListBeginScan を呼び出した後、ドライバーは WdfChildListAddOrUpdateChildDescriptionAsPresent を繰り返し呼び出すか、WdfChildListUpdateAllChildDescriptionsAsPresent を呼び出して、親デバイスに現在接続されているすべての子デバイスを報告できます。

ドライバーが子リストの更新を完了したら、 WdfChildListEndScan を呼び出す必要があります。 この呼び出しにより、更新された子リストがプラグ アンド プレイ (PnP) マネージャーに配信されます。 その後、フレームワークは、ドライバーが報告した各デバイスの ドライバーの EvtChildListCreateDevice コールバック関数を呼び出します。

子リストの詳細については、「 動的列挙」を参照してください。

WdfChildListBeginScan を使用するコード例については、「WdfChildListAddOrUpdateChildDescriptionAsPresent」を参照してください。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfchildlist.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent