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)

另請參閱

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate