Функция WdfChildListBeginScan (wdfchildlist.h)
[Применимо только к KMDF]
Метод WdfChildListBeginScan подготавливает указанный список дочерних устройств, чтобы драйвер смог обновить сведения в списке.
Синтаксис
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Параметры
[in] ChildList
Дескриптор дочернего объекта списка платформы.
Возвращаемое значение
Никакой
Замечания
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Метод 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) |