(wdfchildlist.h WDF_RETRIEVE_CHILD_FLAGS 枚举)

[仅适用于 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_CHILD_LIST_ITERATOR结构中设置 WDF_RETRIEVE_CHILD_FLAGS 类型的标志。

要求

要求
最低 KMDF 版本 1.0
标头 wdfchildlist.h (包括 Wdf.h)

另请参阅

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice