Функция KsFreeObjectBag (ks.h)

Функция KsFreeObjectBag очищает и освобождает контейнер объектов.

Синтаксис

void KsFreeObjectBag(
  [in] KSOBJECT_BAG ObjectBag
);

Параметры

[in] ObjectBag

KSOBJECT_BAG (эквивалент типа PVOID) для очистки и последующего освобождения.

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

None

Remarks

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

KsFreeObjectBag удаляет все элементы, присутствующие в ObjectBag. Кроме того, если число ссылок для заданного объекта равно нулю (то есть объект отсутствует в любом другом контейнере объектов, связанном с тем же устройством, что и ObjectBag), этот элемент освобождается.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib
IRQL PASSIVE_LEVEL

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

KsAddItemToObjectBag

KsAllocateObjectBag

KsCopyObjectBagItems

KsDiscard

KsRemoveItemFromObjectBag