Share via


CBaseRenderer::CheckReady

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later