CBaseRenderer::CheckReady
A version of this page is also available for
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 |