Функция WdfFdoLockStaticChildListForIteration (wdffdo.h)

  • Статья

[Относится только к KMDF]

Метод WdfFdoLockStaticChildListForIteration подготавливает платформу для получения элементов из статического дочернего списка, который принадлежит указанному родительскому устройству.

Синтаксис

void WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

Параметры

[in] Fdo

Дескриптор объекта устройства платформы, который представляет родительское устройство.

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

None

Remarks

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

Драйверы шины, использующие перечисление статической шины, могут вызывать WdfFdoLockStaticChildListForIteration.

После вызова WdfFdoLockStaticChildListForIteration драйвер может многократно вызывать WdfFdoRetrieveNextStaticChild , чтобы получить сведения о каждом дочернем устройстве в списке дочерних элементов.

После завершения вызова WdfFdoRetrieveNextStaticChild драйвер должен вызвать WdfFdoUnlockStaticChildListFromIteration.

Если драйвер вносит изменения в дочерний список после вызова WdfFdoLockStaticChildListForIteration, платформа сохраняет все изменения и уведомляет руководителя Plug and Play (PnP) об изменениях при вызове драйвера WdfFdoUnlockStaticChildListFromIteration.

Драйвер может вкладывать вызовы в WdfFdoLockStaticChildListForIteration и WdfFdoUnlockStaticChildListFromIteration. Если драйвер вложен в вызовы этих методов, платформа сохраняет все изменения до последнего вызова WdfFdoUnlockStaticChildListFromIteration.

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

Примеры

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

Требования

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

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

WdfFdoUnlockStaticChildListFromIteration