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