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

Статья
02/26/2024

Функция KsMergeAutomationTables объединяет две таблицы автоматизации.

Синтаксис

KSDDKAPI NTSTATUS KsMergeAutomationTables(
  [out]          PKSAUTOMATION_TABLE *AutomationTableAB,
  [in, optional] PKSAUTOMATION_TABLE AutomationTableA,
  [in, optional] PKSAUTOMATION_TABLE AutomationTableB,
  [in, optional] KSOBJECT_BAG        Bag
);

Параметры

[out] AutomationTableAB

Указатель на расположение, в котором помещается указатель на KSAUTOMATION_TABLE . Эта структура является итоговой объединенной таблицей автоматизации.

[in, optional] AutomationTableA

Указатель на структуру KSAUTOMATION_TABLE , представляющую первую из двух таблиц автоматизации для слияния. Эта таблица является доминирующей по отношению к повторяющимся записям. Если значение РАВНО NULL, AutomationTableB копируется в AutomationTableAB и при необходимости помещается в контейнер.

[in, optional] AutomationTableB

Указатель на структуру KSAUTOMATION_TABLE , представляющую вторую из двух таблиц автоматизации для слияния. Если значение NULL, AutomationTableA копируется в AutomationTableAB и при необходимости помещается в контейнер.

[in, optional] Bag

Созданная таблица автоматизации помещается в эту KSOBJECT_BAG (эквивалентную типу PVOID) для последующей очистки. Этот параметр является необязательным.

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

KsMergeAutomationTables возвращает STATUS_SUCCESS в случае успешного завершения слияния. В случае неудачи возвращается код ошибки. Наиболее частым кодом ошибки является STATUS_INSUFFICIENT_RESOURCES, что указывает на нехватку системных ресурсов для завершения слияния.

Записи в AutomationTableA имеют приоритет в слиянии. Если в AutomationTableA и AutomationTableB есть запись, то в AutomationTableA будет помещена запись в объединенную таблицу. Только что созданная таблица автоматизации помещается в запрошенный контейнер объектов, если она указана.

Если входная таблица находится в контейнере объектов во время вызова, AVStream удаляет таблицу из контейнера объектов до возврата KsMergeAutomationTables .

Если параметр Bag не имеет значение NULL, перед вызовом этой процедуры мини-driver должен принять мьютекс, связанный с контейнером объектов. Если контейнер связан с булавкой или фильтром, необходимо удерживать мьютекс элемента управления. Если контейнер связан с фабрикой фильтров или устройством, то мьютекс устройства должен быть удержан. Дополнительные сведения см. в разделе Мьютексы в AVStream.

Также см . статьи Контейнеры объектов и Определение таблиц автоматизации.

Требования

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

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

KsAddItemToObjectBag

KsCopyObjectBagItems

KsRemoveItemFromObjectBag

Share via