Функция 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 KSPIN, которая является закреплением, из которого Закрепление получает делегированные кадры. Если пин-код является делегатором, AVStream задает этот параметр для NULL.
Возвращаемое значение
Никакой
Замечания
фильтры, ориентированные на фильтр, получают аналогичные CopySource и сведения о делегатеBranch, когда AVStream вызывает функцию AVStrMiniFilter Process avStrMiniFilterProcess с массивом структур KSPROCESSPIN_INDEXENTRY.
Единственное различие заключается в том, что KsPinGetCopyRelationships возвращает указатели на PKSPIN, а не указатели на PKSPROCESSPIN. Дополнительные сведения о параметрах CopySource и DelegateBranch см. в разделе AVStream Splitters.
Все закрепления работают независимо в контексте фильтра, ориентированного на пин-код. В результате мини-driver, вызывающий KsPinGetCopyRelationships, отвечает за обеспечение выполнения соответствующей синхронизации до времени вызова.
Чтобы гарантировать безопасность при вызове KsPinGetCopyRelationships, получите мьютекс управления (не используйте этот механизм в диспетчере обработки) или убедитесь, что пин-код не переходит под KSSTATE_PAUSE при вызове или использовании полученной информации. Дополнительные сведения о мьютексах см. в Мьютексах в AVStream.
Дополнительные сведения см. в разделе Pin-Centric Обработка и Filter-Centric обработки.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |