WDF_CHILD_LIST_ITERATOR 構造体 (wdfchildlist.h)

[アーティクル]
02/26/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 列挙体によって定義される 1 つ以上のフラグ。

Reserved[4]

内部使用専用に予約されています。

注釈

ドライバーは、WDF_CHILD_LIST_ITERATOR_INITを呼び出して 、WDF_CHILD_LIST_ITERATOR 構造体を初期化する必要があります。

WDF_CHILD_LIST_ITERATOR構造体は、 WdfChildListBeginIteration、WdfChildListRetrieveNextDevice 、および WdfChildListEndIteration メソッドへの入力として使用されます。ドライバーは、WdfChildListBeginIteration を呼び出す前に Flags メンバーを設定する必要があります。 WdfChildListBeginIteration を呼び出した後、WdfChildListEndIteration を呼び出すまで、ドライバーは構造体の内容を変更しないでください。

子リストの詳細については、「動的列挙」を参照してください。