WDF_RETRIEVE_CHILD_FLAGS 열거형(wdfchildlist.h)

아티클
02/07/2025

[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 대한 호출은 존재, 보류 중 또는 누락된 자식 디바이스를 검색합니다.