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

Статья
02/26/2024

[Применяется только к 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)