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의 뮤텍스를 참조하세요.

자세한 내용은 핀 중심 처리 및 필터 중심 처리를 참조하세요.

요구 사항

추가 정보

KSPIN_DESCRIPTOR_EX

KSPROCESSPIN