WDF_RETRIEVE_CHILD_FLAGS列舉 (wdfchildlist.h)

發行項
02/26/2024

[僅適用於 KMDF]

WDF_RETRIEVE_CHILD_FLAGS列舉會定義驅動程式可以在呼叫 WdfChildListBeginIteration 之前設定的旗標。

Syntax

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 將會擷取存在、擱置或遺失的子裝置。