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 |