WDF_RETRIEVE_CHILD_FLAGS 列挙 (wdfchildlist.h)

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

注釈

WdfChildListBeginIteration を呼び出す前に、ドライバーはWDF_CHILD_LIST_ITERATOR構造体でWDF_RETRIEVE_CHILD_FLAGS型指定フラグを設定する必要があります。

要件

要件
最小 KMDF バージョン 1.0
Header wdfchildlist.h (Wdf.h を含む)

こちらもご覧ください

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice