WdfChildListBeginIteration 함수(wdfchildlist.h)

아티클
02/27/2024

[KMDF에만 적용]

WdfChildListBeginIteration 메서드는 지정된 자식 목록에서 항목을 검색하기 위한 프레임워크를 준비합니다.

구문

void WdfChildListBeginIteration(
  [in] WDFCHILDLIST             ChildList,
  [in] PWDF_CHILD_LIST_ITERATOR Iterator
);

매개 변수

[in] ChildList

프레임워크 자식 목록 개체에 대한 핸들입니다.

[in] Iterator

검색할 자식 디바이스의 유형을 나타내는 호출자가 할당한 WDF_CHILD_LIST_ITERATOR 구조체에 대한 포인터입니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

WdfChildListBeginIteration을 호출한 후 드라이버는 WdfChildListRetrieveNextDevice를 반복적으로 호출하여 자식 목록의 각 자식 디바이스에 대한 정보를 가져올 수 있습니다.

드라이버가 WdfChildListRetrieveNextDevice 호출을 완료한 후 WdfChildListEndIteration을 호출해야 합니다.

드라이버가 WdfChildListBeginIteration을 호출한 후 자식 목록을 변경하는 경우 프레임워크는 모든 변경 내용을 저장하고 드라이버가 WdfChildListEndIteration을 호출할 때 변경 내용을 PnP(플러그 앤 플레이) 관리자에게 알릴 수 있습니다.

드라이버는 WdfChildListBeginIteration 및 WdfChildListEndIteration 에 대한 호출을 중첩할 수 있습니다. 드라이버가 이러한 메서드에 대한 호출을 중첩하는 경우 프레임워크는 WdfChildListEndIteration에 대한 마지막 호출까지 모든 변경 내용을 저장합니다.

자식 목록에 대한 자세한 내용은 동적 열거형을 참조하세요.

예제

WdfChildListBeginIteration을 사용하는 코드 예제는 WdfChildListRetrieveNextDevice를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfchildlist.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)