KsPinGetCopyRelationships 函数 (ks.h)

KsPinGetCopyRelationships 函数返回以引脚为中心的筛选器中包含的引脚的复制关系信息。

语法

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

[in] Pin

指向要从中获取复制信息的 KSPIN 结构的指针。

[out] CopySource

指向 KSPIN 结构的指针的指针，该结构是 Pin 的复制源。如果 Pin 是复制源，则 AVStream 将此参数设置为 NULL。

[out] DelegateBranch

指向 KSPIN 结构的指针的指针，该结构是 Pin 从中接收委托帧的引脚。如果 Pin 是委托器，则 AVStream 将此参数设置为 NULL。

无

当 AVStream 使用KSPROCESSPIN_INDEXENTRY结构数组调用微型驱动程序的 AVStrMiniFilterProcess 函数时，以筛选器为中心的筛选器会收到类似的 CopySource 和 DelegateBranch 信息。

唯一的区别是 KsPinGetCopyRelationships 返回指向 PKSPIN 的指针，而不是指向 PKSPROCESSPIN 的指针。有关 CopySource 和 DelegateBranch 参数的详细信息，请参阅 AVStream 拆分器。

所有引脚在以引脚为中心的筛选器的上下文中独立运行。因此，调用 KsPinGetCopyRelationships 的微型驱动程序负责确保在调用时间之前执行适当的同步。

为了保证调用 KsPinGetCopyRelationships 时的安全性，请获取控制互斥体 (不要在处理调度) 中使用此机制，或者确保引脚在调用或使用获取的信息时不会转换到 KSSTATE_PAUSE 以下。有关互斥的详细信息，请参阅 AVStream 中的 Mutexes。

要求	值
最低受支持的客户端	在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。
目标平台	通用
标头	ks.h (包括 Ks.h)
Library	Ks.lib