WdfFdoGetDefaultChildList 関数 (wdffdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfFdoGetDefaultChildList メソッドは、指定されたデバイスの既定の子リストへのハンドルを返します。

構文

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

パラメーター

[in] Fdo

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

戻り値

操作が成功した場合、 WdfFdoGetDefaultChildList は 、Fdo で指定されたデバイスに関連付けられている既定の子リストへのハンドルを返します。 それ以外の場合、メソッドは NULL を返します。

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

注釈

WdfFdoGetDefaultChildList を呼び出す前に、ドライバーは WdfFdoInitSetDefaultChildListConfig を呼び出して既定の子リストを構成する必要があります。 それ以外の場合、 WdfFdoGetDefaultChildList は NULL を返します。

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

例

次のコード例では、デバイスの既定の子リストへのハンドルを取得します。

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

要件

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

こちらもご覧ください

WdfFdoInitSetDefaultChildListConfig