Поделиться через


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

[Применимо только к KMDF]

Метод WdfFdoGetDefaultChildList возвращает дескриптор в дочерний список по умолчанию указанного устройства.

Синтаксис

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

Параметры

[in] Fdo

Дескриптор объекта устройства платформы.

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

Если операция выполнена успешно, WdfFdoGetDefaultChildList возвращает дескриптор дочернего списка по умолчанию, связанного с устройством, указанным Fdo. В противном случае метод возвращает NULL.

Проверка системной ошибки возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Перед вызовом WdfFdoGetDefaultChildListдрайвер должен вызвать WdfFdoInitSetDefaultChildListConfig, чтобы настроить дочерний список по умолчанию. В противном случае WdfFdoGetDefaultChildList возвращает NULL.

Дополнительные сведения о дочерних списках см. в динамического перечисления.

Примеры

Следующий пример кода получает дескриптор дочернего списка устройства по умолчанию.

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Требования

Требование Ценность
целевая платформа универсальный
минимальная версия KMDF 1.0
Заголовок wdffdo.h (include Wdf.h)
Библиотека Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL <= DISPATCH_LEVEL
правил соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfFdoInitSetDefaultChildListConfig