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) |