Функция WdfCollectionRemove (wdfcollection.h)
[Применимо к KMDF и UMDF]
Метод WdfCollectionRemove удаляет объект из указанной коллекции объектов.
Синтаксис
void WdfCollectionRemove(
[in] WDFCOLLECTION Collection,
[in] WDFOBJECT Item
);
Параметры
[in] Collection
Дескриптор объекта коллекции.
[in] Item
Дескриптор объекта платформы, который будет удален из коллекции.
Возвращаемое значение
Никакой
Замечания
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Когда WdfCollectionRemove удаляет объект из коллекции, он уменьшает количество ссылок объекта.
Дополнительные сведения о коллекциях объектов см. в коллекциях объектов Framework.
Примеры
В следующем примере кода удаляется указанный объект из указанной коллекции объектов.
WdfCollectionRemove(
hCollection,
hObject
);
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия 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) |