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。

返回值

无

备注

总线驱动程序必须先调用 WdfFdoInitSetDefaultChildListConfig ，然后才能为 FDO) (功能设备对象调用 WdfDeviceCreate 。 有关调用 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
标头 wdffdo.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL PASSIVE_LEVEL
DDI 符合性规则 ChildListConfiguration (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate