CBaseRenderer::WaitForRenderTime
Microsoft DirectShow 9.0 |
CBaseRenderer::WaitForRenderTime
The WaitForRenderTime method waits for the current sample's presentation time.
Syntax
virtual HRESULT WaitForRenderTime(void);
Return Value
Returns one of the following HRESULT values.
Value | Description |
S_OK | Success. |
VFW_E_STATE_CHANGED | The filter state changed before the presentation time arrived. |
Remarks
This method waits until one of the following occurs:
- The sample's presentation time arrives, at which point the sample can be rendered.
- The filter stops or begins flushing data.
If the presentation time arrives, the CBaseRenderer::m_RenderEvent event is signaled. If the state changes, the CBaseRenderer::m_ThreadSignal event is signaled. This method waits on both events. The derived class can override this method to wait on additional events, if necessary.
This method calls the CBaseRenderer::OnWaitStart method when the wait begins, and the CBaseRenderer::OnWaitEnd method when the wait is done. Neither method does anything in the base class, but the derived class can override them.
Requirements
** Header:** Declared in Renbase.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also