Функция WdfChildListBeginScan (wdfchildlist.h)

  • Статья

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

Метод WdfChildListBeginScan подготавливает указанный список дочерних устройств, чтобы драйвер смог обновить сведения в списке.

Синтаксис

void WdfChildListBeginScan(
  [in] WDFCHILDLIST ChildList
);

Параметры

[in] ChildList

Дескриптор дочернего объекта списка платформы.

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

None

Remarks

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

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

После вызова WdfChildListBeginScan драйвер может повторно вызывать WdfChildListAddOrUpdateChildDescriptionAsPresent или вызывать WdfChildListUpdateAllChildDescriptionsAsPresent, чтобы сообщить обо всех дочерних устройствах, которые в настоящее время подключены к родительскому устройству.

После завершения обновления дочернего списка драйвер должен вызвать WdfChildListEndScan. Этот вызов доставляет обновленный дочерний список диспетчеру Plug and Play (PnP). Впоследствии платформа будет вызывать функцию обратного вызова EvtChildListCreateDevice драйвера для каждого устройства, о чем сообщил драйвер.

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

Примеры

Пример кода, в котором используется WdfChildListBeginScan, см. в разделе WdfChildListAddOrUpdateChildDescriptionAsPresent.

Требования

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

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

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent