Microsoft DirectX 9.0

IMSVidPlayback::put_EnableResetOnStop

This topic applies to Windows XP only.

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 situaitions, the filter graph may be torn down and rebuilt during play. For example, this can happen if the monitor resolution is changed 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, it resumes from the point where playback was interruptes. 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 stream can be seeked. The seek command might fail, depending on the source.

See Also