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 |
|
| Library |
|