IMFASFStreamSelector::GetBandwidthStep method

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

dwStepNum [in]

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.

pdwBitrate [out]

Receives the bit rate associated with the bandwidth step.

rgwStreamNumbers [out]

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.

rgSelections [out]

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 codeDescription
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]

Header

Wmcontainer.h

Library

Mfuuid.lib

See also

IMFASFStreamSelector
IMFASFStreamSelector::GetBandwidthStepCount

 

 

Show: