IMFASFStreamSelector::GetBandwidthStep method (wmcontainer.h)

Article
02/22/2024

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

Requirement	Value
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