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)

另请参阅

IWMPControls 接口 (VB 和 C#)

IWMPControls.next (VB 和 C#)

IWMPControls.pause (VB 和 C#)

IWMPControls.play (VB 和 C#)

IWMPControls.previous (VB 和 C#)