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」 傳遞至 IWMPControls.isAvailable 屬性， (C# ) 中的 IWMPControls.get_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#)