Функция KsFreeObjectCreateItemsByContext (ks.h)
Освобождает все элементы создания с определенным контекстом.
Синтаксис
KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
[in] KSDEVICE_HEADER Header,
[in] PVOID Context
);
Параметры
[in] Header
Указывает на заголовок устройства, на котором присоединены элементы создания.
[in] Context
Содержит контекст создания элементов для освобождения. Все элементы создания с этим значением контекста будут освобождены.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если элемент был освобожден, в противном случае STATUS_OBJECT_NAME_NOT_FOUND.
Замечания
Вместо освобождения элементов по имени как KsFreeObjectCreateItems эта функция освобождает все элементы с определенным контекстом. Например, все элементы создания, связанные с фабрикой фильтров, будут иметь фабрику в качестве контекста и могут быть освобождены одновременно с этим вызовом вместо одного одновременно. Обратите внимание, что эта функция не предполагает сериализации нескольких изменений в списке записей создания вызывающего объекта.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |