WDF_RETRIEVE_CHILD_FLAGS 列挙 (wdfchildlist.h)

[アーティクル]
06/01/2023

[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 を呼び出すと、存在、保留中、または見つからない子デバイスが取得されます。