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 ，才能呼叫 WdfDeviceCreate 以取得功能裝置物件 (FDO) 。 如需呼叫 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
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdffdo.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | ChildListConfiguration (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf ) 、 KmdfIrql (kmdf ) 、 KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) |