CBaseRenderer Class (Windows CE 5.0)

Send Feedback

ms938389.rbase02(en-us,MSDN.10).gif

This is the base renderer class for writing renderers.

This class handles a single input pin, all state changes, and synchronization.

Protected Data Members

Member Description
m_bAbort Used to stop rendering data.
m_bEOS Indicator for whether there are more samples in the stream.
m_bEOSDelivered Indicator for whether an EC_COMPLETE event has been delivered.
m_bRepaintStatus Flag to determine if an EC_REPAINT message can be signaled.
m_bStreaming Indicator for whether the filter graph is currently streaming.
m_dwAdvise Timer advise token returned by the clock.
m_EndOfStreamTimer Time that specifies the end of the stream.
m_evComplete Event signaled when the pause state is complete.
m_InterfaceLock Critical section for interfaces.
m_pInputPin Renderer input pin object.
m_pMediaSample Current media sample about to be or being rendered.
m_pPosition CRendererPosPassThru object for passing positioning data upstream.
m_pQSink Quality control sink.
m_RendererLock Controller for access to current media sample.
m_RenderEvent Used to signal timer events.
m_SignalTime Amount of time that must elapse before CBaseRenderer returns EC_COMPLETE.
m_ThreadSignal Event signaled to release the source filter thread.

Member Functions

Member function Description
Active Is called when the state is switched to paused or running.

Override to add functionality.

CBaseRenderer Constructs a CBaseRenderer object.
CheckReady Determines if the event is set.
DisplayRendererState Displays the status of the video renderer.

Available only in debug mode.

GetRealState Retrieves the actual state of the renderer.
GetRenderEvent Retrieves the event to render.
IsEndOfStream Determines if the end of the stream has been reached.
IsEndOfStreamDelivered Determines if the end of the stream has been delivered to the filter graph manager.
IsStreaming Determines if the filter is currently rendering data.
NotifyEndOfStream Sends an EC_COMPLETE event to the filter graph manager.
NotReady Forces the m_evComplete event into a nonsignaled state.
Ready Puts the m_evComplete event into a signaled state.
ResetEndOfStreamTimer Sets the end of stream timer to zero.
ScheduleSample Sets up an advise link with the clock.
SendNotifyWindow Passes the notification window handle to the upstream filter.
SendRepaint Conditionally signals an EC_REPAINT message to the filter graph.
SetAbortSignal Sets the abort signal flag.
SetRepaintStatus Resets the repaint status flag.
SignalTimerFired Resets the current advise time to zero after a timer fires.
TimerCallback Checks if it is time to signal the end of the current data stream.

Overrideable Member Functions

Member function Description
BeginFlush Signals the start of flushing on the input pin.
BreakConnect Breaks the input pin connection and resets the end-of-stream flags.
CancelNotification Cancels scheduled notification with the clock.
CheckMediaType Determines if the renderer will accept a given media type.
ClearPendingSample Is called to release the pending sample after it is rendered.
CompleteConnect Called as part of the connection protocol.

Override to add functionality.

CompleteStateChange Ensures that a sample is waiting before allowing a pause.
DoRenderSample Is called when a sample is ready to render.
EndFlush Is called when the input pin receives an end-flush notification.
EndOfStream Is called when the input pin receives an end-of-stream notification.
GetCurrentSample Retrieves the sample waiting at the video renderer.
GetPin Returns a CBasePin object to the renderer.
GetPinCount Returns the number of input pins supported.
GetMediaPositionInterface Retrieves IMediaPosition and IMediaSeeking interfaces for the video renderer.
GetSampleTimes Retrieves sample time information for this sample.
HaveCurrentSample Determines if a sample is waiting at the renderer.
Inactive Is called when going into a stopped state.

Override to add functionality.

NonDelegatingQueryInterface Returns an interface and increments the reference count.
OnReceiveFirstSample Provides derived classes with an opportunity to render static data.
OnRenderEnd Notifies the derived class that a sample is finished rendering.
OnRenderStart Notifies the derived class that a sample is about to be rendered.
OnStartStreaming Notifies the derived class that rendering has started.
OnStopStreaming Notifies the derived class that rendering has stopped.
OnWaitEnd Notifies the derived class that a wait for a rendering time has just ended.
OnWaitStart Notifies the derived class that a wait for a rendering time is about to start.
Pause Tells the renderer to transition to the new (paused) state.
PrepareReceive Is called to schedule a clock time when the renderer receives a sample.
PrepareRender Allows derived classes to set themselves just before a sample is rendered.
Receive Is called by the source filter when a sample is available to render.
Render Asks the derived class to render the sample.
ResetEndOfStream Resets the end-of-stream flag.
Run Transitions the renderer to State_Running if it is not in this state.
SendEndOfStream Sets the end-of-stream flag.
SetMediaType Informs the derived class of the selected media type.
ShouldDrawSampleNow Determines if the sample should be drawn between the start and stop times given.
SourceThreadCanWait Sets or resets the thread event.
StartStreaming Called to schedule a pending sample with the clock, and to display timing information.
Stop Tells the renderer to transition to the new (stopped) state.
StopStreaming Sets an internal flag to indicate not to schedule arrival of more samples.
WaitForRenderTime Waits for either the time to arrive or for rendering to be stopped.

Implemented IMediaFilter Methods

Method Description
GetState Determines the state of the renderer.

Implemented IBaseFilter Methods

Method Description
FindPin Retrieves a pointer to the pin with the specified identifier. (There is only one pin.)

Helper Function

Function Description
WaitForReceiveToComplete Waits for the CBaseRenderer::Receive method to complete.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.