IWMPControls::stop (método)

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método stop detiene la reproducción del elemento multimedia.

Sintaxis

public void stop();

Public Sub stop()
Implements IWMPControls.stop

Parámetros

Este método no tiene parámetros.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Este método hace que Reproductor multimedia de Windows libere los recursos del sistema que está usando, como el dispositivo de audio. Sin embargo, el elemento multimedia actual no se libera.

Cuando se detiene Reproductor multimedia de Windows, la posición de reproducción actual del elemento multimedia se restablece al principio del elemento. Posteriormente, al llamar a IWMPControls.play se iniciará la reproducción desde el principio del elemento multimedia. Para detener una operación de reproducción sin cambiar la posición actual, use el método IWMPControls.pause .

Ejemplos

En el ejemplo siguiente se usa stop para detener el elemento multimedia actual en respuesta al evento Click de un botón. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada 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

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	WMPLib
Ensamblado	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Consulte también

Interfaz IWMPControls (VB y C#)

IWMPControls.next (VB y C#)

IWMPControls.pause (VB y C#)

IWMPControls.play (VB y C#)

IWMPControls.previous (VB y C#)