CBaseRenderer 클래스

cbaserenderer class hierarchy

클래스 CBaseRenderer 는 렌더러 필터를 구현하기 위한 기본 클래스입니다. CRendererInputPin 클래스에 의해 구현된 하나의 입력 핀을 지원합니다. 이 클래스를 사용하려면 상속되는 파생 클래스를 선언합니다 CBaseRenderer. 최소한 파생 클래스는 기본 클래스에서 순수 가상으로 선언된 다음 메서드를 구현해야 합니다.

  • CBaseRenderer::CheckMediaType: 제안된 미디어 형식을 수락하거나 거부합니다. 필터는 핀 연결 프로세스 중에 이 메서드를 호출합니다.
  • CBaseRenderer::D oRenderSample: 샘플을 렌더링합니다. 필터는 실행하는 동안 수신되는 모든 샘플에 대해 이 메서드를 호출합니다.

기본 클래스는 상태 변경 및 동기화 문제를 처리합니다. 또한 품질 관리 측정값을 구현하지는 않지만 렌더링 샘플을 예약합니다. 또한 기본 클래스는 여러 "처리기" 메서드를 선언합니다. 이러한 메서드는 스트리밍 프로세스의 특정 지점에서 필터가 호출하는 메서드입니다. 기본 클래스에서는 아무 작업도 수행하지 않지만 파생 클래스는 재정의할 수 있습니다. 다음 표에서는 공용 메서드: 처리기라는 제목 아래에 나열됩니다.

CBaseRenderer::OnReceiveFirstSample 처리기는 특별한 언급이 필요합니다. 필터가 일시 중지되는 동안 샘플을 받으면 필터가 이 메서드를 호출합니다. 그래프가 중지됨에서 일시 중지됨으로 전환되거나 일시 중지된 상태에서 그래프를 찾는 경우에 발생할 수 있습니다. 비디오 렌더러는 일반적으로 샘플을 사용하여 스틸 프레임을 표시합니다. 필터가 일시 중지에서 실행으로 전환되면 스트림의 첫 번째 샘플인 CBaseRenderer::D oRenderSample 메서드에 동일한 샘플을 보냅니다.

클래스는 CBaseRendererCRendererPosPassThru 개체를 통해 IMediaSeekingIMediaPosition 인터페이스를 노출합니다. 모든 검색 요청을 다음 필터 업스트림으로 전달합니다.

일정 계획

업스트림 필터가 입력 핀의 IMemInputPin::Receive 메서드를 호출하여 샘플을 전달하면 핀은 이 호출을 필터의 CBaseRenderer::Receive 메서드로 전달합니다. 필터는 샘플을 삭제하거나, 즉시 렌더링하거나, 렌더링을 위해 예약합니다.

샘플에 타임스탬프를 사용하지 않거나 참조 클록을 사용할 수 없는 경우 필터는 샘플을 즉시 렌더링합니다. 그렇지 않으면 필터는 CBaseRenderer::ShouldDrawSampleNow 메서드를 호출하여 수행할 작업을 결정합니다. 기본적으로 샘플은 타임스탬프를 기반으로 예약됩니다. 파생 클래스는 품질 관리를 지원하도록 ShouldDrawSampleNow 를 재정의할 수 있습니다.

샘플을 예약하기 위해 필터는 IReferenceClock::AdviseTime 메서드를 호출하여 조언 요청을 만듭니다. 그러면 Receive 메서드는 예약된 시간까지 또는 필터 상태가 변경될 때까지 차단합니다. 차단은 현재 샘플이 렌더링될 때까지 업스트림 필터가 더 많은 샘플을 제공하지 못하게 합니다.

업스트림 필터가 IPin::EndOfStream 메서드를 호출하여 스트림의 끝을 알리는 경우 필터는 필터 그래프 관리자에게 EC_COMPLETE 이벤트를 보냅니다. 필터는 이벤트를 보내기 전에 현재 샘플의 중지 시간을 기다립니다.

보호된 멤버 변수 Description
m_bAbort 렌더링을 중지하고 추가 샘플을 거부할지 여부를 나타내는 플래그입니다.
m_bEOS 스트림의 끝에 도달했는지 여부를 나타내는 플래그입니다.
m_bEOSDelivered 필터가 EC_COMPLETE 이벤트를 게시했는지 여부를 나타내는 플래그입니다.
m_bInReceive 필터가 수신 호출을 처리하고 있는지 여부를 나타내는 플래그입니다.
m_bRepaintStatus 다시 그리기 이벤트를 사용하거나 사용하지 않도록 설정하는 플래그입니다.
m_bStreaming 필터가 스트리밍 데이터인지 여부를 나타내는 플래그입니다.
m_dwAdvise 렌더링을 예약하는 타이머 이벤트의 식별자입니다.
m_EndOfStreamTimer EC_COMPLETE 알림을 예약하기 위한 타이머 이벤트 식별자입니다.
m_evComplete 상태 전환이 완료될 때 신호를 받은 이벤트입니다.
m_InterfaceLock 필터 상태 잠금입니다.
m_ObjectCreationLock 잠금을 사용하여 필터 내의 개체 생성을 보호합니다.
m_pInputPin 필터의 입력 핀에 대한 포인터입니다.
m_pMediaSample 현재 미디어 샘플에 대한 포인터입니다.
m_pPosition seek 명령을 업스트림으로 전달하는 도우미 개체입니다.
m_pQSink 품질 관리 메시지를 받는 개체에 대한 포인터입니다.
m_RendererLock 스트리밍 잠금.
m_RenderEvent 렌더링을 예약하는 데 사용되는 이벤트입니다.
m_SignalTime 현재 샘플에서 시간을 중지합니다.
m_ThreadSignal 스트리밍 스레드를 해제하는 데 사용되는 이벤트입니다.
Public 메서드 Description
CancelNotification 렌더링을 예약하는 타이머 이벤트를 취소합니다. 가상.
CBaseRenderer 생성자 메서드입니다.
~CBaseRenderer 소멸자 메서드입니다.
GetMediaPositionInterface 필터의 IMediaPositionIMediaSeeking 인터페이스 포인터를 검색합니다. 가상.
GetPin 핀을 검색합니다. 가상.
GetPinCount 핀 수를 검색합니다. 가상.
GetSampleTimes 샘플에서 타임스탬프를 검색합니다. 가상.
OnDisplayChange 필터 그래프 관리자에 EC_DISPLAY_CHANGED 이벤트를 게시합니다.
PrepareReceive 샘플을 렌더링할 준비를 합니다. 가상.
받기 스트림에서 다음 미디어 샘플을 받습니다. 가상.
Render 샘플을 렌더링합니다. 가상.
ScheduleSample 렌더링 샘플을 예약합니다. 가상.
SendNotifyWindow 비디오 창 핸들의 업스트림 필터에 알립니다.
SendRepaint 필터 그래프 관리자에 다시 그리기 이벤트를 보냅니다.
SetMediaType 핀의 미디어 유형이 설정되면 호출됩니다. 가상.
SignalTimerFired 렌더링을 예약하는 데 사용되는 타이머 식별자를 지웁니다.
SourceThreadCanWait 스트리밍 스레드를 보유하거나 해제합니다. 가상.
WaitForReceiveToComplete CBaseRenderer::Receive 메서드가 완료될 때까지 기다립니다.
WaitForRenderTime 현재 샘플의 프레젠테이션 시간을 기다립니다. 가상.
Public 메서드: 접근자 메서드 Description
ClearPendingSample 현재 샘플을 릴리스합니다. 가상.
GetCurrentSample 현재 샘플을 검색합니다. 가상.
GetRealState 필터 상태를 검색합니다.
GetRenderEvent 렌더링을 예약하는 이벤트를 검색합니다.
HaveCurrentSample 필터에 샘플이 있는지 여부를 확인합니다. 가상.
IsEndOfStream 스트림 종료 알림이 수신되었는지 여부를 쿼리합니다.
IsEndOfStreamDelivered EC_COMPLETE 이벤트가 필터 그래프 관리자에 전달되었는지 여부를 쿼리합니다.
IsStreaming 필터가 데이터를 스트리밍하는지 여부를 쿼리합니다.
SetAbortSignal 렌더링을 중지할지 여부를 나타내는 플래그를 설정하고 추가 샘플을 거부합니다.
SetRepaintStatus 다시 그리기 이벤트를 사용하거나 사용하지 않도록 설정합니다.
public 메서드: State-Change 메서드 Description
활성 상태가 일시 중지되거나 실행 중으로 전환될 때 호출됩니다. 가상.
BeginFlush 플러시 작업을 시작합니다. 가상.
BreakConnect 연결에서 입력 핀을 해제합니다. 가상.
CheckReady 상태 전환이 완료되었는지 여부를 쿼리합니다.
CompleteConnect 다른 핀에 대한 입력 핀 연결을 완료합니다. 가상.
CompleteStateChange 일시 중지된 상태로의 전환이 완료되었는지 여부를 결정합니다. 가상.
EndFlush 플러시 작업을 종료합니다. 가상.
비활성 상태가 중지됨으로 전환될 때 호출됩니다. 가상.
NotReady 상태 전환이 아직 완료되지 않았다는 신호입니다.
준비 상태 전환이 완료되었음을 알 수 있습니다.
StartStreaming 필터가 실행 중 상태로 전환되면 스트리밍을 시작합니다. 가상.
StopStreaming 필터가 실행 중 상태에서 전환되면 스트리밍을 중지합니다. 가상.
공용 메서드: 스트림 끝 메서드 Description
EndOfStream 입력 핀이 스트림 종료 알림을 수신했음을 필터에 알림 가상.
NotifyEndOfStream 필터 그래프 관리자에 EC_COMPLETE 이벤트를 게시합니다.
ResetEndOfStream 스트림 끝 플래그를 다시 설정합니다.
ResetEndOfStreamTimer EC_COMPLETE 알림을 예약하는 타이머를 취소합니다. 가상.
SendEndOfStream 스트림의 끝에 도달한 경우 필터 그래프 관리자에 대한 EC_COMPLETE 이벤트를 예약합니다. 가상.
TimerCallback 스트림 종료 타이머 이벤트에 대한 콜백 메서드입니다.
공용 메서드: 처리기 Description
OnReceiveFirstSample 일시 중지하는 동안 필터가 샘플을 수신할 때 호출됩니다. 가상.
OnRenderEnd 샘플이 렌더링된 후 호출됩니다. 가상.
OnRenderStart 렌더링이 시작되려고 할 때 호출됩니다. 가상.
OnStartStreaming 필터가 스트리밍을 시작할 때 호출됩니다. 가상.
OnStopStreaming 필터가 스트리밍을 중지할 때 호출됩니다. 가상.
OnWaitEnd 필터가 완료되면 샘플의 프레젠테이션 시간을 기다리는 동안 호출됩니다. 가상.
OnWaitStart 필터가 샘플의 프레젠테이션 시간을 기다리기 시작할 때 호출됩니다. 가상.
PrepareRender 필터가 샘플을 렌더링하기 전에 호출됩니다. 가상.
ShouldDrawSampleNow 렌더링을 위해 샘플을 예약하는 방법을 결정합니다. 가상.
순수 가상 메서드 Description
CheckMediaType 필터가 특정 미디어 형식을 허용하는지 여부를 확인합니다.
DoRenderSample 샘플을 렌더링합니다.
IMediaFilter 메서드 Description
GetState 필터의 상태(실행 중, 중지 또는 일시 중지됨)를 검색합니다.
일시 중지 필터를 일시 중지합니다.
실행 필터를 실행합니다.
중지 필터를 중지합니다.
IBaseFilter 메서드 Description
FindPin 지정된 식별자를 사용하여 핀을 검색합니다.

요구 사항

요구 사항
헤더
Renbase.h(스트림.h 포함)
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)