перечисление 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) |