WdfCollectionGetCount 함수(wdfcollection.h)

[KMDF 및 UMDF에 적용]

WdfCollectionGetCount 메서드는 현재 개체 컬렉션에 있는 개체의 수를 반환합니다.

구문

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

매개 변수

[in] Collection

컬렉션 개체에 대한 핸들입니다.

반환 값

WdfCollectionGetCount 는 컬렉션에 있는 개체의 수를 반환합니다.

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

설명

개체 컬렉션에 대한 자세한 내용은 프레임워크 개체 컬렉션을 참조하세요.

예제

다음 코드 예제에서는 지정된 컬렉션의 개체 수를 가져오고 이 숫자를 사용하여 컬렉션의 모든 개체를 검사합니다.

ULONG count;

count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
    ObjectHandle = WdfCollectionGetItem(
                                        CollectionHandle,
                                        i
                                        );
    // 
    // Perform object-specific operations.
    // 
}

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfcollection.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfCollectionGetItem