Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This property specifies the clip's playback rate. This property is read/write.

Compatibility:Windows Media Player, ActiveMovie

Syntax

MediaPlayer.Rate [ = 
dblRate ]

Parameters

dblRate

Double value specifying the clip's playback rate. The default value is 1.0.

Remarks

This property acts as a multiplier value that allows you to play the clip at a faster or slower rate.

The default value of 1.0 indicates the authored speed.

The audio track becomes difficult to understand at rates lower than 0.5 or higher than 1.5.

A playback rate of 2 equates to twice the usual playback speed.

Other considerations apply as well, depending on media type:

  • Advanced streaming format (ASF):Optimal values for this property are from 1 to 10 or from –1 to –10.

    Values with an absolute magnitude greater than 10 are allowed, but not very meaningful.

    Audio plays only when the value is 1.

    An ASF file must be stopped and the AllowScanproperty must be true before you can set the Rateproperty.

    Negative values for this property indicate reversed playback.

    This property applies only to files that meet the same conditions as stated in the section describing the CanScanproperty.

  • Other Media Types:Setting this property at run time is similar to performing a seek operation, and changes the position to the specified point in the clip. The new value must be within the range specified by the SelectionStartand SelectionEndproperties.

The Play, Pause, and Stopmethods all reset this property to the default (1.0). As a result, you must set this property while playback is underway, and must reset it to its new value after every pause/unpause or stop/restart.

ActiveMovie compatibility mode is only supported through Windows CE .NET 4.1.

Requirements

Windows Embedded CE Windows CE 3.0 and later

See Also