WdfCollectionRemoveItem 함수(wdfcollection.h)

[KMDF 및 UMDF에 적용]

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

통사론

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

[in] Collection

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

[in] Index

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

없음

드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.

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

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)