WdfFdoInitSetDefaultChildListConfig 関数 (wdffdo.h)
[KMDF にのみ適用]
WdfFdoInitSetDefaultChildListConfig メソッドは、バス ドライバーの既定の子リストを構成します。
構文
void WdfFdoInitSetDefaultChildListConfig(
[in, out] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_CHILD_LIST_CONFIG Config,
[in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);
パラメーター
[in, out] DeviceInit
ドライバーが EvtDriverDeviceAdd コールバック関数から取得したWDFDEVICE_INIT構造体へのポインター。
[in] Config
ドライバーによって割り当てられた WDF_CHILD_LIST_CONFIG 構造体へのポインター。
[in, optional] DefaultChildListAttributes
ドライバーの既定の子リストを表す子リスト オブジェクトのオブジェクト属性を含む呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。
戻り値
なし
解説
バス ドライバーは、機能デバイス オブジェクト (FDO) の WdfDeviceCreate を呼び出す前に、WdfFdoInitSetDefaultChildListConfig を呼び出す必要があります。 WdfDeviceCreate の呼び出しの詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。
WdfFdoInitSetDefaultChildListConfig メソッドの詳細については、「バス上のデバイスの列挙」を参照してください。
例
次のコード例では、 WDF_CHILD_LIST_CONFIG 構造体を初期化し、 WdfFdoInitSetDefaultChildListConfig を呼び出します。
WDF_CHILD_LIST_CONFIG config;
WDF_CHILD_LIST_CONFIG_INIT(
&config,
sizeof(MY_IDENTIFICATION_DESCRIPTION),
My_EvtDeviceListCreatePdo
);
config.EvtChildListIdentificationDescriptionDuplicate = My_EvtChildListIdentificationDescriptionDuplicate;
config.EvtChildListIdentificationDescriptionCompare = My_EvtChildListIdentificationDescriptionCompare;
config.EvtChildListIdentificationDescriptionCleanup = My_EvtChildListIdentificationDescriptionCleanup;
WdfFdoInitSetDefaultChildListConfig(
DeviceInit,
&config,
WDF_NO_OBJECT_ATTRIBUTES
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdffdo.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | ChildListConfiguration(kmdf)、 DeviceInitAPI(kmdf)、 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |