Share via


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

See also

IMSVidPlayback Interface