KsPinGetCopyRelationships 函式 (ks.h)
KsPinGetCopyRelationships 函式會傳回釘選中心篩選內包含之針腳的複製關聯性資訊。
語法
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
參數
[in] Pin
您想要從中取得複製資訊的 KSPIN 結構的指標。
[out] CopySource
指向屬於 Pin 複製來源之 KSPIN 結構的指標。 如果 Pin 是複製來源，AVStream 會將此參數設定為 NULL。
[out] DelegateBranch
指向 KSPIN 結構的指標，該結構是 Pin 接收委派框架的針腳。 如果 Pin 是委派器，AVStream 會將此參數設定為 NULL。
傳回值
無
備註
當 AVStream 使用KSPROCESSPIN_INDEXENTRY結構的陣列呼叫 minidriver 的 AVStrMiniFilterProcess 函式時，篩選中心篩選條件會收到類似的 CopySource 和 DelegateBranch 資訊。
唯一的差異在於 KsPinGetCopyRelationships 會傳回 PKSPIN 的指標，而不是 PKSPROCESSPIN 的指標。 如需 CopySource 和 DelegateBranch 參數的詳細資訊，請參閱 AVStream 分割器。
所有針腳都會在針腳中心篩選的內容中獨立運作。 因此，呼叫 KsPinGetCopyRelationships 的迷你驅動程式會負責確保適當的同步處理是在呼叫時間之前執行。
若要保證呼叫 KsPinGetCopyRelationships 時的安全性，請取得控制 mutex (不會在處理分派中使用這項機制) ，或確定針腳在呼叫或使用取得 的資訊時， 不會在KSSTATE_PAUSE下方轉換。 如需 mutex 的詳細資訊，請參閱 AVStream 中的 Mutexes。
如需詳細資訊，請參閱 以針腳為中心的處理 和 篩選中心處理。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |