DirectShow DirectShow 레퍼런스 DirectShow base class base class 레퍼런스 CTransformFilter   [목차열람] [주소복사] [슬롯비우기]

CTransformFilter 클래스

CTransformFilter 클래스는, 변환 필터를 처리 하는 base class이다. 이 클래스는 1 개의 입력 핀과 1 개의 출력 핀을 가지는 변환 필터를 처리 하기 위해서 설계되고 있다. 입력 핀과 출력 핀에 다른 할당자를 사용한다. 인 플레이스로 데이터를 처리하는 필터를 생성 하려면 ,CTransInPlaceFilter 클래스를 사용하는 것.

이 필터는 입력 핀에 CTransformInputPin 클래스를 사용해, 출력 핀에 CTransformOutputPin 클래스를 사용한다. 보통, 이러한 핑크 라스를 오버라이드(override) 할 필요는 없다. 대부분의 핀 메서드는 CTransformFilter 클래스에서 대응하는 메서드를 호출하므로, 필요에 따라서 그 필터 메서드를 오버라이드(override) 할 수 있다. 필터는CTransformFilter::GetPin 메서드내에서 양쪽 모두의 핀을 생성 한다. 핑크 라스를 오버라이드(override) 하는 경우,GetPin 를 오버라이드(override) 해 커스텀 핀을 생성 해야 한다.

이 클래스를 사용하려면 , 새로운 클래스를 CTransformFilter 로부터 파생해, 이하의 메서드를 처리 한다.

• CTransformFilter::CheckInputType
• CTransformFilter::CheckTransform
• CTransformFilter::DecideBufferSize
• CTransformFilter::GetMediaType
• CTransformFilter::Transform

필터의 요구에 의해, 다른 메서드를과 같이 오버라이드(override) 할 필요가 있는 경우도 있다.

미디어 타입

이 필터의 입력 핀은, 어느 미디어 타입도 제시하지 않는다. 접속의 미디어 타입의 제시를 업 스트림 필터에 의존한다. 이와 같이 설계되고 있는 이유는, 대부분의 경우 업 스트림 필터가 포맷에 대해보다 많은 정보를 제공할 수 있기 때문에 있다. 예를 들어, 비디오 포맷의 경우, 업 스트림 필터는, 비디오 넓이와 frame rate를 인식하고 있지만, 전송 필터는, 이 정보를 판단하는 방법을 가지지 않는다. 이 동작을 변경하려면 , 입력 핀의 GetMediaType 메서드를 오버라이드(override) 한다. 업 스트림 필터가 미디어 타입을 제시 하면, 입력 핀이 필터의 CheckInputType 메서드 (순수 가상)를 호출한다.

입력 핀이 접속될 때까지, 출력 핀은 모든 접속을 거부해, 우선 미디어 타입을 아무것도 돌려주지 않는다. 입력 핀이 접속되면 출력 핀은 필터의 GetMediaType 메서드를 호출해 우선 타입의 리스트를 돌려준다. 출력 핀은, 필터의 CheckTransform 메서드를 사용해 접속의 출력 타입을 조사한다. (어느 쪽의 메서드도 순수 가상이다. ) 보통, 입력 타입은, 사용 가능한 출력 타입의 결정에 영향을 미친다.

필터에 따라서는,필터 맵퍼 개체를 필터를 찾아낼 수 있도록(듯이), 필터로 지원 되는 몇개의 미디어 타입을 등록하는 것이 좋은 경우가 있다. 더 자세한 정보는, 「DirectShow 필터의 등록 방법」을 참조할것.

스트리밍

이 클래스는 출력 데이터를 큐에 넣지 않는다. 각 출력 샘플은 IMemInputPin::Receive 메서드 내부로부터 출력된다. Receive 메서드는, 필터의 Transform 메서드 (순수 가상)를 호출해, 데이터를 처리한다.

요건

헤더 : Transfrm.h 내에서 선언해, Streams.h 를 인클루드 한다.

라이브러리 : Strmbase.lib (리테일 빌드) 또는 Strmbasd.lib (디버그 빌드)를 사용한다.