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.

Código devuelto	Descripción
S_OK	Correcto.
VFW_S_DUPLICATE_NAME	Se ha agregado correctamente un filtro con un nombre duplicado.
E_FAIL	Error.
E_OUTOFMEMORY	Memoria insuficiente.
E_POINTER	Argumento de puntero NULL.
VFW_E_CERTIFICATION_FAILURE	El uso de este filtro está restringido por una clave de software.
VFW_E_DUPLICATE_NAME	No se pudo agregar un filtro con un nombre duplicado.

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

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

IFilterGraph (interfaz)