WdfFdoLockStaticChildListForIteration 関数 (wdffdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfFdoLockStaticChildListForIteration メソッドは、指定された親デバイスに属する静的子リストから項目を取得するためのフレームワークを準備します。

構文

void WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

パラメーター

[in] Fdo

親デバイスを表すフレームワーク デバイス オブジェクトへのハンドル。

戻り値

なし

解説

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

静的バス列挙を使用するバス ドライバーは 、WdfFdoLockStaticChildListForIteration を呼び出すことができます。

WdfFdoLockStaticChildListForIteration を呼び出した後、ドライバーは WdfFdoRetrieveNextStaticChild を繰り返し呼び出して、子リスト内の各子デバイスに関する情報を取得できます。

ドライバーが WdfFdoRetrieveNextStaticChild の呼び出しを完了したら、 WdfFdoUnlockStaticChildListFromIteration を呼び出す必要があります。

WdfFdoLockStaticChildListForIteration を呼び出した後にドライバーが子リストに変更を加えると、フレームワークはすべての変更を格納し、ドライバーが WdfFdoUnlockStaticChildListFromIteration を呼び出したときに、プラグ アンド プレイ (PnP) マネージャーに変更を通知します。

ドライバーは 、WdfFdoLockStaticChildListForIteration と WdfFdoUnlockStaticChildListFromIteration の呼び出しを入れ子にすることができます。 ドライバーがこれらのメソッドの呼び出しを入れ子にした場合、フレームワークは WdfFdoUnlockStaticChildListFromIteration の最後の呼び出しまですべての変更を格納します。

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

例

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

要件

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

こちらもご覧ください

WdfFdoUnlockStaticChildListFromIteration