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

  • Статья

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

Метод WdfCollectionRemove удаляет объект из указанной коллекции объектов.

Синтаксис

void WdfCollectionRemove(
  [in] WDFCOLLECTION Collection,
  [in] WDFOBJECT     Item
);

Параметры

[in] Collection

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

[in] Item

Дескриптор объекта платформы, который будет удален из коллекции.

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

None

Remarks

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

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

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

Примеры

В следующем примере кода удаляется указанный объект из указанной коллекции объектов.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия 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)

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

WdfCollectionRemoveItem