Interfaz IAMStreamControl (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 IAMStreamControl interfaz controla secuencias individuales en un filtro. Las patillas de algunos filtros exponen esta interfaz. Por ejemplo, el filtro mux avi admite esta interfaz en sus patillas de entrada, y el filtro de captura de audio y el filtro de captura de vídeo WDM lo admiten en sus patillas de salida.

Esta interfaz permite a una aplicación activar y desactivar secuencias en momentos especificados. Por ejemplo, una aplicación podría desactivar una secuencia de audio para silenciar el audio durante la vista previa de vídeo. Las aplicaciones de captura pueden usar esta interfaz para especificar los tiempos exactos de inicio y detención para la captura, y para controlar las secuencias de captura y vista previa independientemente entre sí.

Para usar esta interfaz, llame al método IAMStreamControl::StartAt para especificar cuándo se iniciará la entrega de datos y el método IAMStreamControl::StopAt para especificar cuándo dejará de entregar datos. A continuación, llame a IMediaControl::Run en el Administrador de gráficos de filtros para ejecutar el gráfico de filtros. Todas las veces son relativas a cuándo se inicia la ejecución del grafo.

Al usar esta interfaz, tenga en cuenta las siguientes limitaciones:

  • Debe haber un reloj de referencia en el gráfico de filtros.
  • Las patillas de vista previa en tarjetas de captura con superposición de hardware no admiten esta interfaz.
  • Si va a capturar audio y vídeo en un archivo AVI intercalado, el filtro AVI Mux requiere datos ambos flujos. Si detiene una secuencia, el filtro no puede intercalar los datos. Para obtener más información, vea IConfigInterleaving Interface.
Dependiendo de la aplicación, es posible que encuentre el método ICaptureGraphBuilder2::ControlStream más cómodo, ya que admite el control de secuencia en el nivel de grafo, de modo que no tenga que enumerar filtros y patillas individuales.

Desarrolladores de filtros: la clase base CBaseStreamControl implementa esta interfaz.

Herencia

La interfaz IAMStreamControl hereda de la interfaz IUnknown . IAMStreamControl también tiene estos tipos de miembros:

Métodos

La interfaz IAMStreamControl tiene estos métodos.

 
IAMStreamControl::GetInfo

El método GetInfo recupera información sobre la configuración actual del control de secuencias, incluidas las horas de inicio y detención.
IAMStreamControl::StartAt

El método StartAt informa al pin cuándo empezar a entregar datos.
IAMStreamControl::StopAt

El método StopAt informa al pin cuando se detiene la entrega de datos.

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 strmif.h (incluya Dshow.h)

Consulte también

CBaseStreamControl (clase)

Códigos de error y éxito