CBaseRenderer::CheckReady (Compact 2013)

3/26/2014

Determines if the renderer is ready to process the next sample.

Syntax

BOOL CheckReady(void);

Parameters

None.

Return Value

Returns TRUE if the m_evComplete event is currently set, but does not block.

Remarks

This member function calls the CAMEvent::Check member function.

This is mainly used in transitioning to paused states.

When a renderer is paused, it should not complete the state change until it receives data. So although the call to IMediaFilter::Pause completes immediately, if the application calls IMediaFilter::GetState it returns VFW_S_STATE_INTERMEDIATE.

When a sample arrives at the renderer, the event that is initially reset during the pause call is signaled. At this point, an application calling IMediaFilter::GetState returns NOERROR.

This process allows an application to pause a filter graph and wait until data is queued and ready to be rendered.

Requirements

See Also

Reference

CBaseRenderer Class