EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN コールバック関数 (wdfchildlist.h)

  • [アーティクル]

[KMDF にのみ適用]

ドライバーの EvtChildListScanForChildren イベント コールバック関数は、存在するすべての子デバイスを報告する必要があります。

構文

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

パラメーター

[in] ChildList

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

戻り値

なし

解説

バス ドライバーが動的列挙を使用している場合は、WdfFdoInitSetDefaultChildListConfig または WdfChildListCreate を呼び出すことによって、EvtChildListScanForChildren コールバック関数を登録できます。

ドライバーが EvtChildListScanForChildren コールバック関数を提供する場合、フレームワークは、親デバイスが動作 (D0) 状態になるたびに呼び出します。 (このコールバック関数が呼び出されるタイミングの詳細については、「 PnP と Power Management のシナリオ」を参照してください)。

ドライバーは、次の操作を行って、すべての子デバイスを報告する必要があります。

  1. WdfChildListBeginScan を呼び出すと、以前に報告されたすべての子デバイスが見つからないものとしてマークされます。
  2. 子デバイスを検出し、検出された各デバイスに対して WdfChildListAddOrUpdateChildDescriptionAsPresent を呼び出します。
  3. WdfChildListEndScan を呼び出します。これにより、報告された子デバイスが PnP マネージャーに通知されます。
動的列挙の詳細については、「 バス上のデバイスの列挙」を参照してください。

EvtChildListScanForChildren コールバック関数は、IRQL = PASSIVE_LEVELで呼び出されます。 このコールバック関数を ページング可能にしないでください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfchildlist.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL (「解説」セクションを参照)

こちらもご覧ください

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig