WdfCollectionGetCount 함수(wdfcollection.h)

[KMDF 및 UMDF에 적용]

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

통사론

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

매개 변수

[in] Collection

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

반환 값

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

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

발언

개체 컬렉션에 대한 자세한 내용은 Framework 개체 컬렉션참조하세요.

예제

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

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