Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
[Применимо только к 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.
Возвращаемое значение
Нет
Замечания
Драйвер шины должен вызывать WdfFdoInitSetDefaultChildListConfig перед вызовом WdfDeviceCreate для функционального объекта устройства (FDO). Дополнительные сведения о вызове WdfDeviceCreateсм. в создании объекта устройства Framework.
Дополнительные сведения о методе WdfFdoInitSetDefaultChildList Config см. в перечислении устройств на шине.
Примеры
В следующем примере кода инициализируется структура 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 (include Wdf.h) |
| Библиотека | Wdf01000.sys (см. управление версиями библиотеки Платформы).) |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |