Edit

Share via

IMFRateSupport::GetSlowestRate method (mfidl.h)

  • Article

Retrieves the slowest playback rate supported by the object.

Syntax

HRESULT GetSlowestRate(
  [in]  MFRATE_DIRECTION eDirection,
  [in]  BOOL             fThin,
  [out] float            *pflRate
);

Parameters

[in] eDirection

Specifies whether to query to the slowest forward playback rate or reverse playback rate. The value is a member of the MFRATE_DIRECTION enumeration.

[in] fThin

If TRUE, the method retrieves the slowest thinned playback rate. Otherwise, the method retrieves the slowest non-thinned playback rate. For information about thinning, see About Rate Control.

[out] pflRate

Receives the slowest playback rate that the object supports.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
MF_E_REVERSE_UNSUPPORTED
 The object does not support reverse playback.
MF_E_THINNING_UNSUPPORTED
 The object does not support thinning.

Remarks

The value returned in plfRate represents a lower bound. Playback at this rate is not guaranteed. Call IMFRateSupport::IsRateSupported to check whether the boundary rate is supported. For example, a component that supports arbitrarily slow rates will return zero in pflRate, and applications should call IsRateSupported separately to determine whether the component supports rate 0.

If eDirection is MFRATE_REVERSE, the method retrieves the slowest reverse playback rate. This is a negative value, assuming the object supports reverse playback.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

How to Determine Supported Rates

IMFRateSupport