 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Determines if the renderer is ready to process the next sample.
Syntax
BOOL CheckReady(void); |
Parameters
None.
Return Value
Returns TRUE if the m_evCompleteevent is currently set, but does not block.
Remarks
This member function calls the CAMEvent::Checkmember 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::Pausecompletes immediately, if the application calls IMediaFilter::GetStateit 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::GetStatereturns 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 |