Método CBaseFilter.JoinFilterGraph

  • 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 JoinFilterGraph método notifica al filtro que ha unido o dejado un gráfico de filtros. Este método implementa el método IBaseFilter::JoinFilterGraph .

Sintaxis

HRESULT JoinFilterGraph(
       IFilterGraph *pGraph,
  [in] LPCWSTR      pName
);

Parámetros

Pgraph

Puntero a la interfaz IFilterGraph del administrador de gráficos de filtros o NULL si el filtro sale del gráfico.

pName [in]

Puntero a una cadena Unicode que contiene un nombre para el filtro.

Valor devuelto

Devuelve S_OK.

Comentarios

Este método establece la variable miembro CBaseFilter::m_pGraph igual al parámetro pGraph . También consulta un puntero de interfaz IMediaEventSink y lo almacena en la variable miembro CBaseFilter::m_pSink . Sin embargo, el filtro no mantiene un recuento de referencias en ninguna de estas interfaces. Si lo hace, se crearía un recuento de referencias circular, ya que el administrador de gráficos de filtros mantiene un recuento de referencias en el filtro.

El método copia la cadena especificada por pName en la variable miembro CBaseFilter::m_pName .

Requisitos

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

Consulte también

CBaseFilter (clase)