Método IFilterGraph::AddFilter (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.

El AddFilter método agrega un filtro al gráfico.

Sintaxis

HRESULT AddFilter(
  [in] IBaseFilter *pFilter,
  [in] LPCWSTR     pName
);

Parámetros

[in] pFilter

Puntero a la interfaz IBaseFilter del filtro que se va a agregar.

[in] pName

Puntero a una cadena de caracteres anchos que contiene un nombre para el filtro.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Observaciones

El nombre del filtro puede ser NULL, en cuyo caso el Administrador de gráficos de filtros genera un nombre. Si el nombre no es NULL y no es único, este método modificará el nombre en un intento de generar un nuevo nombre único. Si se ejecuta correctamente, este método devuelve VFW_S_DUPLICATE_NAME. Si no puede generar un nombre único, devuelve VFW_E_DUPLICATE_NAME.

AddFilter llama al método IBaseFilter::JoinFilterGraph del filtro para informar al filtro de que se ha agregado. AddFilter debe llamarse antes de intentar usar el método IGraphBuilder::Connect, IFilterGraph::ConnectDirect o IGraphBuilder::Render para conectar o representar patillas que pertenecen al filtro agregado.

El Administrador de gráficos de filtros contiene un recuento de referencias en el filtro hasta que se quita el filtro del gráfico o se libera el Administrador de gráficos de filtros.

Requisitos

Consulte también

Códigos de error y éxito

IFilterGraph (interfaz)