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