WDF_CHILD_LIST_ITERATOR 结构 (wdfchildlist.h)

项目
02/29/2024

[仅适用于 KMDF]

WDF_CHILD_LIST_ITERATOR 结构标识驱动程序调用 WdfChildListRetrieveNextDevice 时框架将检索的子设备类型。

语法

typedef struct _WDF_CHILD_LIST_ITERATOR {
  ULONG Size;
  ULONG Flags;
  PVOID Reserved[4];
} WDF_CHILD_LIST_ITERATOR, *PWDF_CHILD_LIST_ITERATOR;

成员

Size

此结构的大小（以字节为单位）。

Flags

由 WDF_RETRIEVE_CHILD_FLAGS 枚举定义的一个或多个标志。

Reserved[4]

保留以仅供内部使用。

注解

驱动程序必须通过调用 WDF_CHILD_LIST_ITERATOR_INIT 初始化 WDF_CHILD_LIST_ITERATOR 结构。

WDF_CHILD_LIST_ITERATOR 结构用作 WdfChildListBeginIteration、WdfChildListRetrieveNextDevice 和 WdfChildListEndIteration 方法的输入。驱动程序必须在调用 WdfChildListBeginIteration 之前设置 Flags 成员。调用 WdfChildListBeginIteration 后，驱动程序不得修改结构的内容，直到调用 WdfChildListEndIteration 之后。

有关子列表的详细信息，请参阅动态枚举。