Функция KsPinGetCopyRelationships (ks.h)
Функция 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 |