다음을 통해 공유


WdfCollectionGetItem 함수(wdfcollection.h)

[KMDF 및 UMDF에 적용]

WdfCollectionGetItem 메서드는 지정된 개체 컬렉션에 포함되고 지정된 인덱스 값과 연결된 개체에 대한 핸들을 반환합니다.

구문

WDFOBJECT WdfCollectionGetItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

매개 변수

[in] Collection

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

[in] Index

컬렉션의 개체를 식별하는 인덱스 값(0부터 시작)입니다.

반환 값

WdfCollectionGetItem은 프레임워크 개체 핸들을 반환하거나 Index 값이 잘못된 경우 NULL을 반환합니다.

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

설명

인덱스 값은 개체가 컬렉션에 추가되는 순서를 나타냅니다. 인덱스 값 0은 컬렉션의 첫 번째 개체를 나타내고, 1의 인덱스 값은 연결된 목록과 같이 두 번째 개체를 나타냅니다. 드라이버가 컬렉션에서 항목 i 를 제거하면 항목 i+1이 항목 i가 됩니다.

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

예제

WdfCollectionGetItem을 사용하는 코드 예제는 WdfCollectionGetCount를 참조하세요.


요구 사항

요구 사항
대상 플랫폼 유니버설
최소 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)

추가 정보

WdfCollectionGetFirstItem

WdfCollectionGetLastItem