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
Pin이 위임된 프레임을 받는 핀인 KSPIN 구조체에 대한 포인터에 대한 포인터입니다. Pin이 위임자인 경우 AVStream은 이 매개 변수를 NULL로 설정합니다.
반환 값
없음
설명
필터 중심 필터는 AVStream이 KSPROCESSPIN_INDEXENTRY 구조의 배열을 사용하여 미니드라이버의 AVStrMiniFilterProcess 함수를 호출할 때 유사한 CopySource 및 DelegateBranch 정보를 받습니다.
유일한 차이점은 KsPinGetCopyRelationships 가 PKSPROCESSPIN에 대한 포인터가 아닌 PKSPIN에 대한 포인터를 반환한다는 것입니다. CopySource 및 DelegateBranch 매개 변수에 대한 자세한 내용은 AVStream 분할자를 참조하세요.
모든 핀은 핀 중심 필터의 컨텍스트에서 독립적으로 작동합니다. 따라서 KsPinGetCopyRelationships 를 호출하는 미니드라이버가 호출 시간 전에 적절한 동기화가 수행되도록 합니다.
KsPinGetCopyRelationships를 호출할 때 안전을 보장하려면 제어 뮤텍스를 가져오거나(처리 디스패치에서 이 메커니즘을 사용하지 않음) 호출하거나 가져온 정보를 사용하는 동안 핀이 KSSTATE_PAUSE 아래로 전환되지 않도록 합니다. 뮤텍스에 대한 자세한 내용은 AVStream의 뮤텍스를 참조하세요.
자세한 내용은 핀 중심 처리 및 필터 중심 처리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |