Compartir a través de

Método IGraphConfig::SetFilterFlags (strmif.h)

  • 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 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)