Функция WdfFdoInitSetDefaultChildListConfig (wdffdo.h)

Статья
08/08/2023

[Относится только к KMDF]

Метод WdfFdoInitSetDefaultChildListConfig настраивает дочерний список водителя шины по умолчанию.

Синтаксис

void WdfFdoInitSetDefaultChildListConfig(
  [in, out]      PWDFDEVICE_INIT        DeviceInit,
  [in]           PWDF_CHILD_LIST_CONFIG Config,
  [in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);

Параметры

[in, out] DeviceInit

Указатель на структуру WDFDEVICE_INIT , полученную драйвером из функции обратного вызова EvtDriverDeviceAdd .

[in] Config

Указатель на структуру, выделенную драйвером WDF_CHILD_LIST_CONFIG .

[in, optional] DefaultChildListAttributes

Указатель на структуру, выделенную вызывающим объектом WDF_OBJECT_ATTRIBUTES , содержащую атрибуты объекта дочернего списка, представляющего дочерний список драйвера по умолчанию. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

Возвращаемое значение

None

Remarks

Драйвер шины должен вызвать 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
                                    );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdffdo.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate