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 方法的輸入。驅動程式必須先設定 Flags 成員，才能呼叫 WdfChildListBeginIteration。呼叫 WdfChildListBeginIteration 之後，驅動程式在呼叫 WdfChildListEndIteration 之後，不得修改結構的內容。

如需子清單的詳細資訊，請參閱動態列舉。