перечисление WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

  • Статья

[Применяется только к KMDF]

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

Синтаксис

typedef enum _WDF_RETRIEVE_CHILD_FLAGS {
  WdfRetrieveUnspecified = 0x0000,
  WdfRetrievePresentChildren = 0x0001,
  WdfRetrieveMissingChildren = 0x0002,
  WdfRetrievePendingChildren = 0x0004,
  WdfRetrieveAddedChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren),
  WdfRetrieveAllChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren | WdfRetrieveMissingChildren)
} WDF_RETRIEVE_CHILD_FLAGS;

Константы

 
WdfRetrieveUnspecified
Значение: 0x0000
Зарезервировано только для внутреннего использования.
WdfRetrievePresentChildren
Значение: 0x0001
Вызовы WdfChildListRetrieveNextDevice будут извлекать дочерние устройства, для которых существует объект устройства платформы.
WdfRetrieveMissingChildren
Значение: 0x0002
Вызовы WdfChildListRetrieveNextDevice будут извлекать дочерние устройства, помеченные как отсутствующие.
WdfRetrievePendingChildren
Значение: 0x0004
Вызовы WdfChildListRetrieveNextDevice будут извлекать дочерние устройства, которые драйвер сообщил о наличии, но для которых объект устройства платформы не был создан (так как платформа не вызвала функцию обратного вызова EvtChildListCreateDevice драйвера).
WdfRetrieveAddedChildren
Значение: (WdfRetrievePresentChildren
Вызовы WdfChildListRetrieveNextDevice будут извлекать дочерние устройства, которые присутствуют или находятся в состоянии ожидания.
WdfRetrieveAllChildren
Значение: (WdfRetrievePresentChildren
Вызовы WdfChildListRetrieveNextDevice будут извлекать дочерние устройства, которые присутствуют, находятся в состоянии ожидания или отсутствуют.

Комментарии

Перед вызовом WdfChildListBeginIteration драйвер должен задать WDF_RETRIEVE_CHILD_FLAGS типизированные флаги в WDF_CHILD_LIST_ITERATOR структуре.

Требования

Требование Значение
Минимальная версия KMDF 1,0
Верхняя часть wdfchildlist.h (включая Wdf.h)

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

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice