Share via


IMSVidPlayback::put_EnableResetOnStop Method

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(
  [in]  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 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 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 Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

IMSVidPlayback Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008