Interfaz IMediaSeeking (strmif.h)
[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.
La IMediaSeeking interfaz contiene métodos para buscar una posición dentro de una secuencia y para establecer la velocidad de reproducción. El Administrador de gráficos de filtros expone esta interfaz y, por tanto, realiza filtros o patillas individuales. Las aplicaciones deben consultar el Administrador de gráficos de filtros para la interfaz.
Filter Graph Manager distribuye cualquier IMediaSeeking llamada a cada uno de los filtros del representador en el gráfico. Los filtros del representador envían la llamada ascendente a los filtros de origen. Esta secuencia de eventos garantiza que todas las secuencias permanezcan sincronizadas. Si alguna de las llamadas distribuidas devuelve un error, Filter Graph Manager devuelve el primer valor de error que recibió, aunque algunas de las llamadas distribuidas se realicen correctamente. Se E_NOTIMPL una excepción: Filter Graph Manager no devuelve E_NOTIMPL a menos que todas las llamadas distribuidas la devuelvan.
Una aplicación puede buscar el gráfico mientras el gráfico está en cualquier estado (en ejecución, en pausa o detenido). Si el grafo se está ejecutando, el Administrador de gráficos de filtros pausa el gráfico antes de que se produzca el comando seek. A continuación, vuelve a ejecutar el grafo. Todas las operaciones de búsqueda son independientes de la velocidad de reproducción actual. Las operaciones de búsqueda hacen que los datos multimedia pendientes se vacíe del gráfico.
Para todos los IMediaSeeking parámetros que especifican la hora, la unidad de tiempo depende del formato de hora actual. Para establecer el formato de hora, llame al método IMediaSeeking::SetTimeFormat . Los formatos de hora son identificadores únicos globales (GUID) definidos en uuids.h. Para obtener más información, vea GUID de formato de hora.
Herencia
La interfaz IMediaSeeking hereda de la interfaz IUnknown . IMediaSeeking también tiene estos tipos de miembros:
Métodos
La interfaz IMediaSeeking tiene estos métodos.
| IMediaSeeking::CheckCapabilities El método CheckCapabilities consulta si una secuencia ha especificado funcionalidades de búsqueda. |
| IMediaSeeking::ConvertTimeFormat El método ConvertTimeFormat convierte de un formato de una vez a otro. |
| IMediaSeeking::GetAvailable El método GetAvailable recupera el intervalo de tiempos en los que la búsqueda es eficaz. |
| IMediaSeeking::GetCapabilities El método GetCapabilities recupera todas las funcionalidades de búsqueda de la secuencia. |
| IMediaSeeking::GetCurrentPosition El método GetCurrentPosition recupera la posición actual, en relación con la duración total de la secuencia. |
| IMediaSeeking::GetDuration El método GetDuration obtiene la duración de la secuencia. |
| IMediaSeeking::GetPositions El método GetPositions recupera la posición actual y la posición de detención, en relación con la duración total de la secuencia. |
| IMediaSeeking::GetPreroll El método GetPreroll recupera la cantidad de datos que se ponerán en cola antes de la posición inicial. |
| IMediaSeeking::GetRate El método GetRate recupera la velocidad de reproducción. |
| IMediaSeeking::GetStopPosition El método GetStopPosition recupera la hora en la que se detendrá la reproducción, en relación con la duración de la secuencia. |
| IMediaSeeking::GetTimeFormat El método GetTimeFormat recupera el formato de hora que se está usando actualmente para las operaciones de búsqueda. |
| IMediaSeeking::IsFormatSupported El método IsFormatSupported determina si se admite un formato de hora especificado para las operaciones de búsqueda. |
| IMediaSeeking::IsUsingTimeFormat El método IsUsingTimeFormat determina si las operaciones de búsqueda usan actualmente un formato de hora especificado. |
| IMediaSeeking::QueryPreferredFormat El método QueryPreferredFormat recupera el formato de hora preferido para la búsqueda. |
| IMediaSeeking::SetPositions El método SetPositions establece la posición actual y la posición de detención. |
| IMediaSeeking::SetRate El método SetRate establece la velocidad de reproducción. |
| IMediaSeeking::SetTimeFormat El método SetTimeFormat establece el formato de hora para las operaciones de búsqueda posteriores. |
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 (incluye Dshow.h) |