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

Статья
02/26/2024

Функция KsPinGetCopyRelationships возвращает сведения о связи копирования для закрепления, содержащегося в фильтре, ориентированном на контакты .

Синтаксис

void KsPinGetCopyRelationships(
  [in]  PKSPIN Pin,
  [out] PKSPIN *CopySource,
  [out] PKSPIN *DelegateBranch
);

Параметры

[in] Pin

Указатель на структуру KSPIN , из которой требуется получить сведения о копировании.

[out] CopySource

Указатель на указатель на структуру KSPIN , которая является источником копирования для закрепления. Если источником копирования является Закрепление, AVStream присваивает этому параметру значение NULL.

[out] DelegateBranch

Указатель на указатель на структуру KSPIN , которая является контактом, из которого закрепление получает делегированные кадры. Если закрепление является делегатором, AVStream присваивает этому параметру значение NULL.

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

None

Remarks

Фильтры, ориентированные на фильтры , получают аналогичные сведения о CopySource и DelegateBranch , когда AVStream вызывает функцию AVStrMiniFilterProcess мини-driver с массивом KSPROCESSPIN_INDEXENTRY структур.

Единственное отличие заключается в том, что KsPinGetCopyRelationships возвращает указатели на PKSPIN, а не на PKSPROCESSPIN. Дополнительные сведения о параметрах CopySource и DelegateBranch см. в разделе Разделители AVStream.

Все контакты работают независимо в контексте фильтра, ориентированного на контакты. В результате мини-driver, вызывающий KsPinGetCopyRelationships , отвечает за обеспечение выполнения соответствующей синхронизации до времени вызова.

Чтобы гарантировать безопасность при вызове KsPinGetCopyRelationships, получите мьютекс управления (не используйте этот механизм в диспетчеризации обработки) или убедитесь, что закрепление не переходит под KSSTATE_PAUSE при вызове или использовании полученной информации. Дополнительные сведения о мьютексах см. в разделе Мьютексы в AVStream.

Дополнительные сведения см. в разделах Обработка, ориентированная на закрепление и Фильтрация.

Требования

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

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

KSPIN_DESCRIPTOR_EX

KSPROCESSPIN

Share via