Método IMediaSeeking::GetDuration (strmif.h)

  • Artículo

[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 método GetDuration obtiene la duración de la secuencia.

Sintaxis

HRESULT GetDuration(
  [out] LONGLONG *pDuration
);

Parámetros

[out] pDuration

Recibe la duración, en unidades del formato de hora actual.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método obtiene la duración de la secuencia a velocidad de reproducción normal. Cambiar la velocidad de reproducción no afecta a la duración.

La duración se expresa en el formato de hora actual. El formato de hora predeterminado es REFERENCE_TIME unidades (100 nanosegundos). Para cambiar los formatos de hora, use el método IMediaSeeking::SetTimeFormat .

Dependiendo del formato de origen, es posible que la duración no sea exacta. Por ejemplo, si el origen contiene una secuencia de velocidad de bits variable (VBR), el método podría devolver una duración estimada.

Requisitos

Requisito Value
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 strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IMediaSeeking (interfaz)