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

Статья
02/07/2025

Функция 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 и более поздних версий DirectX.
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib
IRQL	PASSIVE_LEVEL