Share via

Функция 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 (включая Ks.h)
Библиотека Ks.lib

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

KsFreeObjectCreateItem