Platforms to show: All Mac Windows Linux Cross-Platform
Back to DirectShowMediaFilterMBS class.
DirectShowMediaFilterMBS.Constructor Private
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
DirectShowMediaFilterMBS.Pause
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
When a filter is paused, it can receive, process, and deliver samples. However, a renderer filter will only accept one sample while paused. Therefore, when the filter graph is paused, samples move through the graph until the first sample reaches the renderer. At that point, streaming is paused until the Run method is called. Video renderers display the first sample as a still frame.
Live capture filters do not deliver any samples while paused, only while running.
The state transition might be asynchronous. If the method returns before the transition completes, the lasterror value is 1. A renderer filter does not complete the transition to paused until either (1) it receives one sample, or (2) it receives an end-of-stream notification. While the state transition is pending, State gives lasterror VFW_S_STATE_INTERMEDIATE.
DirectShowMediaFilterMBS.Run(StartTime as Int64)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
StartTime: Reference time corresponding to stream time 0.
Lasterror is set.
When a filter is running, it can receive, process, and deliver samples. Source filters generate new samples, and renderer filters render them.
The state transition might be asynchronous. If the method returns before the transition completes, the lasterror value is 1.
Stream time is calculated as the current reference time minus StartTime. To calculate when a media sample should be rendered, the renderer compares the time stamp with the current stream time. Thus, a media sample with a time stamp of zero should be rendered at time StartTime. For more information, see Time and Clocks in DirectShow.
When an application calls the Run method, the Filter Graph Manager calls Run on each filter. It sets the value of StartTime slightly in the future, to account for graph latency.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
When a filter is stopped, it does not process or deliver any samples, and it rejects samples from upstream filters.
The state transition might be asynchronous. If the method returns before the transition completes, the lasterror value is 1.
This method always sets the filter's state to kStateStopped, even if the method returns an error code.
The items on this page are in the following plugins: MBS Win Plugin.