Функция 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) |