Partager via


Rate

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 AllowScan property must be true before you can set the Rate property.
    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 CanScan property.
  • 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 SelectionStart and SelectionEnd properties.

The Play, Pause, and Stop methods 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

Reference

Windows Media Player Properties

Concepts

Compatibility Modes
Playback Methods and Properties