KsPinGetCopyRelationships 函数返回 以引脚为中心的 筛选器中包含的引脚的副本关系信息。
语法
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
参数
[in] Pin
指向要从中获取复制信息的 KSPIN 结构的指针。
[out] CopySource
指向指向 KSPIN 结构的指针，该结构是 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 中的互斥体。
有关详细信息，请参阅 Pin-Centric 处理 和 Filter-Centric 处理。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
| 目标平台 | 普遍 |
| 标头 | ks.h （包括 Ks.h） |
| 库 | Ks.lib |