функция обратного вызова EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN (wdfchildlist.h)

  • Статья

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

Функция обратного вызова события EvtChildListScanForChildren драйвера должна сообщать обо всех имеющихся дочерних устройствах.

Синтаксис

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Параметры

[in] ChildList

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

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

None

Remarks

Если драйвер шины использует динамическое перечисление, он может зарегистрировать функцию обратного вызова EvtChildListScanForChildren , вызвав WdfFdoInitSetDefaultChildListConfig или WdfChildListCreate.

Если драйвер предоставляет функцию обратного вызова EvtChildListScanForChildren , платформа вызывает ее каждый раз, когда родительское устройство переходит в рабочее состояние (D0). (Дополнительные сведения о том, когда вызывается эта функция обратного вызова, см. в разделе Сценарии PnP и управления питанием.)

Драйвер должен сообщить обо всех своих дочерних устройствах, выполнив следующие действия.

  1. Вызов WdfChildListBeginScan, который помечает все ранее сообщаемые дочерние устройства как отсутствующие.
  2. Обнаружение дочерних устройств и вызов WdfChildListAddOrUpdateChildDescriptionAsPresent для каждого обнаруженного устройства.
  3. Вызов WdfChildListEndScan, который информирует диспетчера PnP о сообщаемых дочерних устройствах.
Дополнительные сведения о динамическом перечислении см. в разделе Перечисление устройств в шине.

Функция обратного вызова EvtChildListScanForChildren вызывается в IRQL = PASSIVE_LEVEL. Не следует делать эту функцию обратного вызова страничной.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfchildlist.h (включая Wdf.h)
IRQL PASSIVE_LEVEL (см. раздел "Примечания")

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

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig