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

CPosPassThru 클래스

CPosPassThru 클래스는, 변환 필터에 대한 시크 커멘드를 업 스트림에 있는 다음의 필터에 건네주어 처리한다.

애플리케이션이 필터 그래프를 시크 할 때 필터 그래프 매니저는 시크 커멘드를 렌더러 필터에 건네준다. 커멘드는, 커멘드를 실행할 수 있는 필터 (만약 있으면)에 도달할 때까지, 각 필터의 출력 핀을 통해 업 스트림에게 건네진다. 더 자세한 정보는, 「시크」를 참조할것. 다음 그림이 나타내듯CPosPassThru 클래스는 모든 시크 커멘드를 업 스트림 필터의 출력 핀에 보낸다.

이 클래스는 base class 라이브러리에서 제공되고 있지만, DirectShow 에서는 Quartz.dll 에서도 같은 클래스를 제공하고 있다. Quartz.dll 버전을 사용하면 이 클래스는 실행시에 DLL 로부터 로드 되기 (위해)때문에, 필터의 코드 사이즈를 약간 삭감할 수 있다. 그 버전을 사용하려면 ,CreatePosPassThru 함수를 호출한다.

출력 핀의 NonDelegatingQueryInterface 메서드는, 요구된 인터페이스가 IMediaSeeking 또는 IMediaPosition 인 경우는,CPosPassThru 개체에 위임한다. 이것을 다음 코드에 나타낸다.

// 다음의 멤버 변수가 가정되고 있다 :
IPin *m_pInput;    // 필터의 입력 핀의 포인터.
IUnknown *m_pPos;  // CPosPassThru 개체의 포인터.

STDMETHODIMP CMyPin::NonDelegatingQueryInterface(REFIID riid, void **ppv)
{
    HRESULT hr
    if (riid == IID_IMediaPosition || riid == IID_IMediaSeeking) 
    {
        if (m_pPos == NULL) 
        {
                        // CPosPassThru 개체를 아직 생성 하고 있지 않다.  여기서 생성 한다.
            hr = CreatePosPassThru(GetOwner(), FALSE, m_pInput, &m_pPos);
            if (FAILED(hr)) return hr;
        }
        return m_pPos->QueryInterface(riid, ppv);
    } 
    else
    {
                  // 그 외의 인터페이스 (생략).
    }
}

~CMyPin::CMyPin() 
{
        // CPosPassThruObject 를 릴리즈 한다.
    if (m_pPos != NULL) m_pPos->Release();
}

특별히 거절하지 않는 이상 이 클래스의 모든 IMediaPosition 와 IMediaSeeking 메서드는 접속하고 있는 핀의 대응하는 메서드를 호출해, 결과를 돌려준다.

요건

헤더: Ctlutil.h 로 선언해, Streams.h 를 인클루드 한다.

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