Share via

CBaseRenderer::ScheduleSample

  • Article
 
Microsoft DirectShow 9.0

CBaseRenderer::ScheduleSample

The ScheduleSample method schedules a sample for rendering.

Syntax

  virtual BOOL ScheduleSample(
    IMediaSample *pMediaSample
);

Parameters

pMediaSample

Pointer to the sample's IMediaSample interface.

Return Value

Returns TRUE if the sample was scheduled, or FALSE if the sample was dropped.

Remarks

This method first determines whether the sample should be rendered immediately, rendered in the future, or dropped. (To do so, it calls the CBaseRenderer::GetSampleTimes method.) If the sample should be rendered immediately, the method signals the CBaseRenderer::m_RenderEvent event. If the sample should be rendered in the future, the method calls the IReferenceClock::AdviseTime method for scheduling.

Requirements

**  Header:** Declared in Renbase.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also