Método IGraphConfig::SetFilterFlags (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 SetFilterFlags método establece la información de configuración de un filtro.

Sintaxis

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Parámetros

[in] pFilter

Puntero a la interfaz IBaseFilter de un filtro en el gráfico de filtros.

[in] dwFlags

Valor que especifica las nuevas marcas de configuración. Debe ser uno de los siguientes valores:

Valor	Descripción
Cero	No se estableció ninguna marca.
AM_FILTER_FLAGS_REMOVABLE	El filtro se puede mover durante una reconexión dinámica. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
E_POINTER	Argumento de puntero NULL.
E_INVALIDARG	Argumento no válido.
S_OK	Correcto.
VFW_E_NOT_IN_GRAPH	El filtro no está en el gráfico.

Comentarios

La marca AM_FILTER_FLAGS_REMOVABLE cambia el comportamiento del método IGraphConfig::Reconnect . El método Reconnect realiza una reconexión dinámica entre dos patillas. Si el autor de la llamada especifica un pin, pero deja el otro patilla sin especificar, Reconexión busca en sentido ascendente o descendente desde el pin especificado para buscar una coincidencia adecuada. Sin embargo, de forma predeterminada, se produce un error en la búsqueda si alcanza un filtro que se agregó al gráfico mediante el método IFilterGraph::AddFilter . Para invalidar este comportamiento, llame SetFilterFlags a y establezca la marca AM_FILTER_FLAGS_REMOVABLE en el filtro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [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

IGraphConfig (interfaz)