Share via


IWMPNetwork::maxBandwidth property

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The maxBandwidth property gets or sets the maximum allowed bandwidth.

Syntax

public System.Int32 maxBandwidth {get; set;}

Public Property maxBandwidth As System.Int32

Property value

A System.Int32 that is the maximum bandwidth.

Remarks

This property does not have a default value. The value can be specified while Windows Media Player is playing, but the change will not take effect until the current media item is released by opening another one or by calling AxWindowsMediaPlayer.close. Windows Media Player attempts to achieve the highest bandwidth possible. No intentional reduction of bandwidth will occur unless this value is set.

This setting is useful for reducing the amount of bandwidth used, particularly in the case of a multiple bit rate (MBR) stream. An MBR stream contains multiple streams with different bit rates. In some cases, it may be desirable to use a stream with a lower bit rate than the client requires. In this case, specifying a lower bit rate with the IWMPNetwork.maxBandwidth property will select a lower bit-rate stream. For example, an MBR stream might include streams encoded at 20 kilobits per second (Kbps), 37 Kbps, and 200 Kbps. Using IWMPNetwork.maxBandwidth to specify a bit rate of 50,000 (50 Kbps) will select the 37 Kbps stream instead of the 200 Kbps stream.

Requirements

Requirement Value
Version
Windows Media Player 9 Series or later
Namespace
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

See also

AxWindowsMediaPlayer.close (VB and C#)

IWMPNetwork Interface (VB and C#)