Функция 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 (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WdfFdoInitSetDefaultChildListConfig