Método IMediaFilter::Run (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 Run método ejecuta el filtro.

Sintaxis

HRESULT Run(
  REFERENCE_TIME tStart
);

Parámetros

tStart

Hora de referencia correspondiente al tiempo de secuencia 0.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.

Código devuelto Descripción
S_FALSE
 La transición no está completa.
S_OK
 Correcto. La transición se ha completado.

Comentarios

Cuando se ejecuta un filtro, puede recibir, procesar y entregar muestras. Los filtros de origen generan nuevos ejemplos y los filtros del representador los representan.

La transición de estado podría ser asincrónica. Si el método vuelve antes de que finalice la transición, el valor devuelto se S_FALSE.

Stream tiempo se calcula como la hora de referencia actual menos tStart. Para calcular cuándo se debe representar un ejemplo multimedia, el representador compara la marca de tiempo con el tiempo de flujo actual. Por lo tanto, se debe representar un ejemplo multimedia con una marca de tiempo de cero en el momento tStart. Para obtener más información, vea Hora y relojes en DirectShow.

Cuando una aplicación llama al método IMediaControl::Run , el Administrador de gráficos de filtros llama IMediaFilter::Run a en cada filtro. Establece el valor de tStart ligeramente en el futuro, para tener en cuenta la latencia del grafo.

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

IMediaFilter (interfaz)