Функция WdfCollectionRemoveItem (wdfcollection.h)

[Относится к KMDF и UMDF]

Метод WdfCollectionRemoveItem удаляет указанный объект из коллекции объектов на основе указанного значения индекса.

Синтаксис

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

Параметры

[in] Collection

Дескриптор объекта коллекции.

[in] Index

Отсчитываемый от нуля индекс, определяющий удаляемый объект.

Возвращаемое значение

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Значения индекса представляют порядок добавления объектов в коллекцию. Нулевое значение индекса представляет первый объект, добавленный в коллекцию, значение индекса одного представляет второй объект и т. д.

Когда WdfCollectionRemoveItem удаляет объект из коллекции, он уменьшает количество ссылок объекта.

Дополнительные сведения о коллекциях объектов см. в разделе Коллекции объектов платформы.

Примеры

Пример кода, в котором используется 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)

См. также раздел

WdfCollectionRemove