IWMPNetwork::bandWidth 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 bandWidth property gets the current bandwidth of the media item.
Syntax
public System.Int32 bandWidth {get; set;}
Public ReadOnly Property bandWidth As System.Int32
Property value
A System.Int32 that is the bandwidth.
Remarks
The value retrieved through AxWindowsMediaPlayer.URL will be zero if the URL is not set. This property is valid only for streaming media.
Examples
The following example uses bandWidth to display the current media bandwidth. The information is displayed in a label in response to the PlayStateChange Event. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named player.
// Add a delegate for the PlayStateChange event.
player.PlayStateChange += new AxWMPLib._WMPOCXEvents_PlayStateChangeEventHandler(player_PlayStateChange);
// Create an event handler for the PlayStateChange event.
private void player_PlayStateChange(object sender, AxWMPLib._WMPOCXEvents_PlayStateChangeEvent e)
{
// Display the bandwidth when the player is playing.
switch (e.newState)
{
case 3: // Play State = WMPLib.WMPPlayState.wmppsPlaying = 3
if (player.network.bandWidth != 0)
{
bandWidthLabel.Text = "Current Bandwidth: " + player.network.bandWidth + " K bits/second";
}
else
{
bandWidthLabel.Text = "Bandwidth is only available for streaming media.";
}
break;
default:
break;
}
}
' Create an event handler for the PlayStateChange event.
Public Sub player_PlayStateChange(ByVal sender As Object, ByVal e As AxWMPLib._WMPOCXEvents_PlayStateChangeEvent) Handles player.PlayStateChange
' Display the bandWidth when the player is playing.
Select Case e.newState
Case 3 ' Play State = WMPLib.WMPPlayState.wmppsPlaying = 3
If (player.network.bandWidth <> 0) Then
bandWidthLabel.Text = "Current Bandwidth: " + player.network.bandWidth + " K bits/second"
Else
bandWidthLabel.Text = "Bandwidth is only available for streaming media."
End If
End Select
End Sub
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 9 Series or later |
| Namespace |
WMPLib |
| Assembly |
|