IWMPNetwork::d ownloadProgress-Eigenschaft

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die downloadProgress-Eigenschaft ruft den Prozentsatz des abgeschlossenen Downloads ab.

Syntax

public System.Int32 downloadProgress {get; set;}

Public ReadOnly Property downloadProgress As System.Int32

Eigenschaftswert

Ein System.Int32-Wert , bei dem es sich um den Downloadfortschritt handelt, ausgedrückt als Prozentsatz.

Bemerkungen

Wenn das Windows Medienwiedergabe-Steuerelement mit einer digitalen Mediendatei verbunden ist, die gleichzeitig wiedergegeben und heruntergeladen werden kann, ruft die downloadProgress-Eigenschaft den Prozentsatz der heruntergeladenen Gesamtdatei ab. Dieses Feature wird derzeit nur für digitale Mediendateien unterstützt, die von Webservern heruntergeladen werden. Eine Datei mit einem der folgenden Formate kann gleichzeitig heruntergeladen und wiedergegeben werden:

• Advanced Systems Format (ASF)
• Windows Media Audio (WMA)
• Windows Media Video (WMV)
• MP3
• MPEG
• WAV

Darüber hinaus können einige AVI-Dateien heruntergeladen und gleichzeitig wiedergegeben werden.

Verwenden Sie die AxWindowsMediaPlayer._WMPOCXEvents_BufferingEvent , um zu bestimmen, wann die Pufferung gestartet oder beendet wird.

Beispiele

Im folgenden Codebeispiel wird downloadProgress verwendet, um den Prozentsatz der abgeschlossenen Downloads anzuzeigen. Die Informationen werden als Reaktion auf das Pufferereignis in einer Bezeichnung angezeigt. Im Beispiel wird ein Timer mit einem Intervall von 1 Sekunde verwendet, um die Anzeige zu aktualisieren. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable mit dem Namen player dargestellt.

// Add a delegate for the Buffering event.
player.Buffering += new AxWMPLib._WMPOCXEvents_BufferingEventHandler(player_Buffering);

// Create an event handler for the Buffering event.
private void player_Buffering(object sender, AxWMPLib._WMPOCXEvents_BufferingEvent e)
{
    // Determine whether buffering has started or stopped.
    if (e.start == true)
    {
        // Set the timer interval at one second (1000 miliseconds).
        timer.Interval = 1000;
        
        // Start the timer.
        timer.Start();
    }
    else
    {
        // Buffering is complete. Stop the timer.
        timer.Stop();
    }
}

// Update the download progress in a timer event handler.
private void UpdateDownloadProgress(object sender, EventArgs e)
{
    downloadProgressLabel.Text = ("Download progress: " + player.network.downloadProgress + " percent complete");
}

' Create an event handler for the Buffering event.
Public Sub player_Buffering(ByVal sender As Object, ByVal e As AxWMPLib._WMPOCXEvents_BufferingEvent) Handles player.Buffering

    ' Test whether packets may be arriving.
    Select Case e.newState

    ' If WMPPlayState is Stopped, Paused, ScanForward, ScanReverse, Waiting, MediaEnded
    ' or Transitioning then stop the timer. 
        Case 1
        Case 2
        Case 4
        Case 5
        Case 7
        Case 8
        Case 9
            timer.Stop()

        ' If WMPPlayState is Playing or Buffering then set the timer interval and start the timer.
        Case Else
            timer.Interval = 1000
            timer.Start()

    End Select

End Sub

' Update the download progress in a timer event handler.
Public Sub UpdateDownloadProgress(ByVal sender As Object, ByVal e As System.EventArgs) Handles timer.Tick

    downloadProgressLabel.Text = ("Download progress: " + player.network.downloadProgress + " percent complete")

End Sub

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Serie 9 oder höher
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Siehe auch

AxWindowsMediaPlayer.Buffering-Ereignis (VB und C#)

IWMPNetzwerkschnittstelle (VB und C#)