Método IMFPMediaPlayer::SetRate (mfplay.h)

  • Artículo
Importante Obsoleto. Esta API se puede quitar de futuras versiones de Windows. Las aplicaciones deben usar la sesión multimedia para la reproducción.
 

Establece la velocidad de reproducción.

Sintaxis

HRESULT SetRate(
  [in] float flRate
);

Parámetros

[in] flRate

Velocidad de reproducción. La velocidad de reproducción se expresa como una relación de la tasa actual con la velocidad normal. Por ejemplo, 1.0 indica la velocidad de reproducción normal, 0,5 indica la mitad de velocidad y 2,0 indica dos veces la velocidad. Los valores positivos indican la reproducción directa y los valores negativos indican la reproducción inversa.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_OUT_OF_RANGE
 El parámetro flRate es cero.
MF_E_SHUTDOWN
 Se llamó al método Shutdown del objeto.

Comentarios

Este método se completa de forma asincrónica. Cuando se completa la operación, se invoca el método de devolución de llamada IMFPMediaPlayerCallback::OnMediaPlayerEvent de la aplicación. El tipo de evento es MFP_EVENT_TYPE_RATE_SET.

El método establece la tasa admitida más cercana, que dependerá del origen de medios subyacente. Por ejemplo, si flRate es 50 y la velocidad máxima del origen es 8× tasa normal, el método establecerá la tasa en 8,0. La tasa real se indica en los datos del evento para el evento MFP_EVENT_TYPE_RATE_SET .

Para encontrar el intervalo de tarifas admitidas, llame a IMFPMediaPlayer::GetSupportedRates.

Este método no admite velocidades de reproducción de cero, aunque Media Foundation define un significado para las tasas cero en otros contextos.

La nueva tarifa solo se aplica al elemento multimedia actual. Al establecer un nuevo elemento multimedia, se restablece la velocidad de reproducción a 1.0.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfplay.h

Consulte también

IMFPMediaPlayer

Uso de MFPlay para la reproducción de audio y vídeo