Método IMediaPosition::p ut_CurrentPosition (control.h)

Artículo
07/28/2023

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, 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 put_CurrentPosition método establece la posición actual, en relación con la duración total de la secuencia.

Sintaxis

HRESULT put_CurrentPosition(
  [in] REFTIME llTime
);

Parámetros

[in] llTime

Nueva posición, en segundos.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles figuran los siguientes:

Código devuelto	Descripción
S_FALSE	El grafo se ha pausado y está en transición a un estado en ejecución.
S_OK	Correcto.
E_INVALIDARG	Argumento no válido.
E_NOTIMPL	Sin implementar.

Observaciones

La posición especificada por el parámetro llTime es relativa a la duración total, ignorando la velocidad de reproducción. Por ejemplo, si un archivo de código fuente tiene 10 segundos de duración, establecer la posición en 5,0 hace que el gráfico busque el centro del archivo, independientemente de la velocidad de reproducción.

Si el grafo de filtro se está ejecutando, el Administrador de gráficos de filtros pausa el gráfico, emite el comando seek y, a continuación, vuelve a ejecutar el grafo. Si el método devuelve mientras el gráfico sigue realizando la transición a un estado en ejecución, el valor devuelto se S_FALSE.

Si un filtro está en pausa cuando recibe un comando seek, debe vaciar los datos existentes antes de introducir los datos de la nueva posición. Consulte IPin::BeginFlush e IPin::EndFlush.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	control.h (incluir Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IMediaPosition (interfaz)

Share via