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

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

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

Синтаксис

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

Параметры

[in] Collection

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

[in] Index

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

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

None

Remarks

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

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

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

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

Примеры

Пример кода, в котором используется WdfCollectionRemoveItem, см. в разделе WdfCollectionGetFirstItem.

Требования

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

WdfCollectionRemove