IStreamBufferConfigure2::SetFFTransitionRates method (sbe.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The SetFFTransitionRates method sets the behavior of fast-forward play ("trick mode") in the Stream Buffer Engine.

Syntax

HRESULT SetFFTransitionRates(
  [in] DWORD dwMaxFullFrameRate,
  [in] DWORD dwMaxNonSkippingRate
);

Parameters

[in] dwMaxFullFrameRate

Maximum playback rate for full-frame playback. The value must be greater than 1. The default value is 4.

[in] dwMaxNonSkippingRate

Maximum playback rate for key-frame playback. The value must be greater than dwFullFrameRate. The default value is 6.

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.

Remarks

At higher playback rates, the Stream Buffer Engine drops frames in order to maintain the desired rate. The following table shows how the values of dwMaxFullFrameRate and dwMaxNonSkippingRate affect playback.

Playback rate Behavior
rate <= dwMaxFullFrameRate Full-frame playback: All frames are sent.
dwMaxFullFrameRate < rate <= dwMaxNonSkippingRate Key-frame playback: All key frames are sent. Delta frames are skipped.
dwMaxNonSkippingRate < rate Key-frame playback with seeking: All delta frames are skipped, and some key frames are skipped. The number of skipped key frames is proportional to the rate.

The decoder may drop frames as well, depending on the data rate, the monitor refresh rate, and the CPU load.

Requirements

Requirement Value
Minimum supported client Windows�XP with SP2 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header sbe.h

See also

IStreamBufferConfigure2 Interface

IStreamBufferMediaSeeking2::SetRateEx