Функция 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
Указатель на структуру 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) |