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_CHILD_LIST_ITERATOR 结构中设置 WDF_RETRIEVE_CHILD_FLAGS类型标志。

要求

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

另请参阅

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice