IWMPControls：：stop 方法

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

stop方法會停止播放媒體專案。

語法

public void stop();

Public Sub stop()
Implements IWMPControls.stop

參數

這個方法沒有任何參數。

傳回值

這個方法不會傳回值。

備註

此方法會導致Windows 媒體播放機釋放它正在使用的任何系統資源，例如音訊裝置。 不過，目前的媒體專案並未釋出。

停止Windows 媒體播放機時，媒體專案中目前的播放位置會重設為專案的開頭。 後續呼叫 IWMPControls.play 將會從媒體專案的開頭開始播放。 若要停止播放作業而不變更目前的位置，請使用 IWMPControls.pause 方法。

範例

下列範例會使用 stop 來停止 目前的媒體專案，以回應按鈕的 Click 事件。 AxWMPLib.AxWindowsMediaPlayer物件是由名為 player 的變數表示。

private void stopButton_Click(object o, System.EventArgs args)
{
    // To get all of the available functionality of the player controls, cast the
    // value returned by player.Ctlcontrols to a WMPLib.IWMPControls3 interface. 
    WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

    // Check first to be sure the operation is valid. 
    if (controls.get_isAvailable("stop"))
    {
        controls.stop();
    }
}

Public Sub stopButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles stopButton.Click

    ' To get all of the available functionality of the player controls, Dim the
    ' value returned by player.Ctlcontrols as a WMPLib.IWMPControls3 interface.
    Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

    ' Check first to be sure the operation is valid. 
    If (controls.isAvailable("stop")) Then

        controls.stop()

    End If

End Sub

規格需求

需求	值
版本	Windows 媒體播放機 9 系列或更新版本
命名空間	WMPLib
組件	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另請參閱

VB 和 C#) (IWMPControls 介面

IWMPControls.next (VB 和 C#)

IWMPControls.pause (VB 和 C#)

IWMPControls.play (VB 和 C#)

IWMPControls.previous (VB 和 C#)