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

Статья
03/01/2024

Функция KsCopyObjectBagItems копирует все элементы из одного контейнера объектов в другой.

Синтаксис

KSDDKAPI NTSTATUS KsCopyObjectBagItems(
  [in] KSOBJECT_BAG ObjectBagDestination,
  [in] KSOBJECT_BAG ObjectBagSource
);

Параметры

[in] ObjectBagDestination

KSOBJECT_BAG (эквивалент типа PVOID), в который копируются элементы.

[in] ObjectBagSource

KSOBJECT_BAG, из которого копируются элементы в ObjectBagDestination.

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

Возвращает STATUS_SUCCESS, если копирование выполнено успешно. В противном случае возвращается код ошибки. Чаще всего это STATUS_INSUFFICIENT_RESOURCES указывает на нехватку системных ресурсов для завершения операции копирования. Если возвращается STATUS_INSUFFICIENT_RESOURCES, вполне возможно, что некоторые, но не все элементы были скопированы из ObjectBagSource в ObjectBagDestination.

Обратите внимание, что мьютексы для обоих мешков должны быть проведены. Если рассматриваемый контейнер объектов связан с фильтром или контактом, получите мьютекс элемента управления фильтром. Если контейнер объектов принадлежит фабрике фильтров или устройству, получите мьютекс устройства. Дополнительные сведения см. в разделе Контейнеры объектов и мьютексы в AVStream.

Требования

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