CRendererPosPassThru class

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The CRendererPosPassThru class handles seek commands for renderer filters, by passing them upstream to the next filter.

This class derives from the CPosPassThru class. It adds support for caching the time stamps from samples as they arrive. Use this class in the same way as the CPosPassThru class. Refer to the CPosPassThru documentation for details.

The renderer filter must update the CRendererPosPassThru object's cached time stamps, as follows:

• For each sample the filter receives, call the CRendererPosPassThru::RegisterMediaTime method.
• When the filter is stopped or receives an EndFlush call, call the CRendererPosPassThru::ResetMediaTime method.
• When the filter receives an end-of-stream notification, call the CRendererPosPassThru::EOS method.

For an example of how to use this class, refer to the CBaseRenderer source code.

Public Methods	Description
CRendererPosPassThru	Constructor method.
GetMediaTime	Retrieves the time stamps on the current sample.
RegisterMediaTime	Caches the time stamps from the current sample.
ResetMediaTime	Resets the cached time stamps to zero.
EOS	Updates the cached time stamps after an end-of-stream notification.

Requirements

Requirement	Value
Header	Ctlutil.h (include Streams.h)
Library	Strmbase.lib (retail builds); Strmbasd.lib (debug builds)