IMFASFStreamSelector::GetBandwidthStep method (wmcontainer.h)

Retrieves the stream numbers that apply to a bandwidth step. This method is used for multiple bit rate (MBR) content.

Syntax

HRESULT GetBandwidthStep(
  [in]  DWORD                dwStepNum,
  [out] DWORD                *pdwBitrate,
  [out] WORD                 *rgwStreamNumbers,
  [out] ASF_SELECTION_STATUS *rgSelections
);

Parameters

[in] dwStepNum

Bandwidth step number for which to retrieve information. Set this value to a number between 0, and 1 less than the number of bandwidth steps returned by IMFASFStreamSelector::GetBandwidthStepCount.

[out] pdwBitrate

Receives the bit rate associated with the bandwidth step.

[out] rgwStreamNumbers

Address of an array that receives the stream numbers. The caller allocates the array. The array size must be at least as large as the value returned by the IMFASFStreamSelector::GetStreamCount method.

[out] rgSelections

Address of an array that receives the selection status of each stream, as an ASF_SELECTION_STATUS value. The members of this array correspond to the members of the rgwStreamNumbers array by index. The caller allocates the array. The array size must be at least as large as the value returned by the IMFASFStreamSelector::GetStreamCount method.

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

Bandwidth steps are bandwidth levels used for MBR content. If you stream MBR content, you can choose the bandwidth step that matches the network conditions to avoid interruptions during playback.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wmcontainer.h
Library Mfuuid.lib

See also

IMFASFStreamSelector

IMFASFStreamSelector::GetBandwidthStepCount