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

CTransformFilter::GetPin

GetPin 메서드는, 핀을 얻어온다.

구문

virtual CBasePin *GetPin(
    int n
);

파라미터

n

지정된 핀의 수 (제로로부터 시작되는 인덱스). 이 필터에서는, 핀 0 은 입력 핀으로, 핀 1 은 출력 핀이다.

반환값

핀을 처리 하는 CBasePin 개체의 포인터를 돌려준다. 메서드가 실패했을 경우는, NULL 를 돌려준다.

주의

이 메서드는 순수 가상 CBaseFilter::GetPin 메서드를 처리 한다. 최초로 이 메서드가 불려 갔을 때, 양쪽 모두의 핀을 생성 한다.

이 메서드는 되돌아 온 핀의 참조 카운트를 인크리먼트(increment) 하지 않기 때문에, 돌아간 핀에는 미처리의 참조 카운트가 남지 않는다. 호출원이 그 핀의 참조 카운트를 보관 유지할 필요가 있는 경우, 그 핀의 IUnknown::AddRef 메서드를 호출해야 하는 것이다.

필터가 디폴트의 CTransformInputPin 핀과 CTransformOutputPin 핀을 사용하는 경우는, 이 메서드를 오버라이드(override) 할 필요는 없다. 그러나, 필터가 이러한 클래스를 확장한 핀을 사용하는 경우는, 이 메서드를 오버라이드(override) 해 그 타입의 핀을 생성 해야 한다.

참조

CTransformFilter 클래스