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

Статья
02/07/2025

[Применимо к KMDF и UMDF]

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

Синтаксис

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

Параметры

[in] Collection

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

[in] Index

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

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

Никакой

Замечания

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

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

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

Дополнительные сведения о коллекциях объектов см. в коллекциях объектов Framework

Примеры

Пример кода, использующий WdfCollectionRemoveItem, см. WdfCollectionGetFirstItem.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfcollection.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfCollectionRemove

Поделиться через