IWMPControls：：fastReverse 方法

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

fastReverse 方法以相反的方向启动媒体项的快速播放。

语法

public void fastReverse();

Public Sub fastReverse()
Implements IWMPControls.fastReverse

参数

此方法没有任何参数。

返回值

此方法不返回值。

备注

fastReverse 方法以正常速度的五倍反向扫描剪辑，如果它是视频文件，则仅显示关键帧。 调用 fastReverse 等效于通过设置 IWMPSettings.rate 属性指定速率的 -5.0。 如果随后更改了速率，或者调用了 IWMPControls.play 或 IWMPControls.stop，Windows 媒体播放器将停止快速反向。

如果项目是播放列表的一部分，fastReverse 会在当前曲目开头停止。例如，如果轨道 3 处于 fastReverse 中，则当到达轨道 3 的开头时，Windows 媒体播放器将不会转到轨道 2。 调用 fastReverse 时，播放计数不会递增。

如果在 fastReverse 运行时调用 IWMPControls.fastForward，则 fastReverse 将停止，IWMPControls.fastForward 将开始。

此方法不适用于实时广播和某些数字媒体类型。 若要确定是否可以在剪辑中使用快速反向，请将 System.String 值“FastReverse”传递给 C#) IWMPControls.get_isAvailable 方法 (IWMPControls.isAvailable 属性。

示例

以下示例使用 fastReverse 来反转当前媒体项，以响应按钮的 Click 事件。 AxWMPLib.AxWindowsMediaPlayer 对象由名为 player 的变量表示。

private void fastReverseButton_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("fastReverse"))
    {
        controls.fastReverse();
    }
}

Public Sub fastReverseButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles fastReverseButton.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("fastReverse")) Then

        controls.fastReverse()

    End If

End Sub

要求

要求	值
版本	Windows 媒体播放器 9 系列或更高版本
命名空间	WMPLib
程序集	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

IWMPControls 接口 (VB 和 C#)

IWMPControls.fastForward (VB 和 C#)

IWMPControls.isAvailable (VB 和 C#)

IWMPControls.play (VB 和 C#)

IWMPControls.stop (VB 和 C#)

IWMPSettings.rate (VB 和 C#)