Share via


Network.maxBandwidth

[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 specifies or retrieves the maximum allowed bandwidth.

Syntax

player.network.maxBandwidth

Possible Values

This property is a read/write Number (long).

Remarks

This property has no default value. Its 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 Player.close. Windows Media Player attempts to achieve the highest bandwidth possible. Only in the case of the value being set will any bandwidth reduction occur.

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, setting the maxBandwidth property will select a lower bit-rate stream.

For example, an MBR stream could include streams encoded at 20 kilobits per second (Kbps), 37 Kbps, and 200 Kbps. Setting the maxBandwidth property to 50,000 (50 Kbps) will select the 37 Kbps stream instead of the 200 Kbps stream.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later.
DLL
Wmp.dll

See also

Network Object

Player.close