Функция WdfChildListBeginIteration (wdfchildlist.h)
[Применяется только к KMDF]
Метод WdfChildListBeginIteration подготавливает платформу для получения элементов из указанного дочернего списка.
Синтаксис
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
Параметры
[in] ChildList
Дескриптор дочернего объекта списка платформы.
[in] Iterator
Указатель на структуру WDF_CHILD_LIST_ITERATOR , выделенную вызывающим объектом, которая указывает тип извлекаемых дочерних устройств.
Возвращаемое значение
None
Remarks
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
После вызова WdfChildListBeginIteration драйвер может многократно вызывать WdfChildListRetrieveNextDevice , чтобы получить сведения о каждом дочернем устройстве в списке дочерних элементов.
После завершения вызова WdfChildListRetrieveNextDevice драйвер должен вызвать WdfChildListEndIteration.
Если драйвер вносит изменения в дочерний список после вызова WdfChildListBeginIteration, платформа сохраняет все изменения и уведомляет диспетчер Plug and Play (PnP) об изменениях, когда драйвер вызывает WdfChildListEndIteration.
Драйвер может вложить вызовы wdfChildListBeginIteration и WdfChildListEndIteration. Если драйвер вложен в вызовы этих методов, платформа сохраняет все изменения до последнего вызова WdfChildListEndIteration.
Дополнительные сведения о дочерних списках см. в разделе Динамическое перечисление.
Примеры
Пример кода, в котором используется WdfChildListBeginIteration, см. в разделе WdfChildListRetrieveNextDevice.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfchildlist.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки платформы). |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |