Método CBasePin.Active

  • 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 Active método notifica al pin que el filtro está ahora activo.

Sintaxis

virtual HRESULT Active();

Parámetros

Este método no tiene parámetros.

Valor devuelto

Devuelve S_OK.

Comentarios

Cuando el filtro pasa de detenido a en pausa, la clase CBaseFilter llama a este método en todas las patillas conectadas del filtro.

Este método no hace nada en la clase base. Las clases derivadas pueden invalidar este método; por ejemplo, un pin podría confirmar asignadores u obtener recursos de hardware.

El estado interno del administrador de gráficos de filtros no se actualiza hasta que se devuelve esta función miembro, por lo que no pruebe el estado de este método.

Requisitos

Requisito Value
Encabezado
Amfilter.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBasePin (clase)