IMSVidPlayback::put_EnableResetOnStop
| Microsoft DirectShow 9.0 |
IMSVidPlayback::put_EnableResetOnStop
This topic applies to Windows XP or later.
The put_EnableResetOnStop method indicates how playback will resume if the graph is rebuilt.
Syntax
HRESULT put_EnableResetOnStop( VARIANT_BOOL newVal );
Parameters
newVal
[in] Specifies one of the following values.
| Value | Description |
| VARIANT_FALSE | The Video Control attempts to start from position where playback was interrupted. (Default) |
| VARIANT_TRUE | The Video Control seeks back to the start before resuming playback. |
Return Values
The method returns an HRESULT. Possible values include the following.
| Value | Description |
| S_OK | The method succeeded. |
Remarks
In some situations, the filter graph may be torn down and rebuilt during play. For example, this can happen if the monitor resolution changes or the screen saver starts. The EnableResetOnStop property specifies whether the Video Control should resume playback where it was interrupted, or should restart at the beginning of the source.
By default, playback resumes from the point where it was interrupted. If newVal is VARIANT_TRUE, however, the Video Control will issue a seek command back to time zero. Note that setting this parameter to VARIANT_TRUE does not guarantee that the seek command will succeed. The seek command might fail, depending on the source.
Requirements
Header: Dshow.h.
Library: Quartz.dll.
See Also