IMediaPosition::put_Rate

  • Article
 
Microsoft DirectShow 9.0

IMediaPosition::put_Rate

The put_Rate method sets the playback rate.

Syntax

  HRESULT put_Rate(
  double dRate
);

Parameters

dRate

[in] Playback rate. Must not be zero.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_NOTIMPL Not implemented.

Remarks

The playback rate is expressed as a ratio of the normal speed. Thus, 1.0 is normal playback speed, 0.5 is half speed, and 2.0 is twice speed. For audio streams, changing the rate also changes the pitch.

For more information, see the remarks in IMediaSeeking::SetRate.

Requirements

Header: Declared in Control.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also