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

Статья
02/07/2025

[Применимо только к 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 получат дочерние устройства, которые присутствуют, находятся в состоянии ожидания или отсутствуют.