WdfCollectionRemoveItem 함수(wdfcollection.h)

[KMDF 및 UMDF에 적용]

WdfCollectionRemoveItem 메서드는 지정된 인덱스 값에 따라 개체 컬렉션에서 지정된 개체를 제거합니다.

구문

void WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

[in] Collection

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

[in] Index

제거할 개체를 식별하는 인덱스(0부터 시작)입니다.

없음

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

인덱스 값은 개체가 컬렉션에 추가되는 순서를 나타냅니다. 인덱스 값 0은 컬렉션에 추가된 첫 번째 개체를 나타내고, 1의 인덱스 값은 두 번째 개체를 나타내는 등입니다.

WdfCollectionRemoveItem이 컬렉션에서 개체를 제거하면 개체의 참조 수가 감소합니다.

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

WdfCollectionRemoveItem을 사용하는 코드 예제는 WdfCollectionGetFirstItem을 참조하세요.

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