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)

こちらもご覧ください

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate