IMSVidPlayback::put_EnableResetOnStop method (segment.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The put_EnableResetOnStop method indicates how playback will resume if the graph is rebuilt.
Syntax
HRESULT put_EnableResetOnStop(
[in] VARIANT_BOOL newVal
);
Parameters
[in] newVal
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 value
The method returns an HRESULT. Possible values include the following.
Return code | Description |
---|---|
|
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 put_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
Requirement | Value |
---|---|
Minimum supported client | Windows�XP [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | segment.h (include Msvidctl.h) |