Método ICaptureGraphBuilder2::GetFiltergraph (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 GetFiltergraph método recupera el grafo de filtro que usa el generador de gráficos de captura.

Sintaxis

HRESULT GetFiltergraph(
  [out] IGraphBuilder **ppfg
);

Parámetros

[out] ppfg

Recibe un puntero de interfaz IGraphBuilder .

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Argumento de puntero NULL.
E_UNEXPECTED	Sin gráfico de filtros.

Comentarios

Inicialmente, el generador de gráficos de captura no contiene un puntero a un grafo de filtro. Este método devuelve E_UNEXPECTED hasta que se haya llamado a uno de los métodos siguientes:

• ICaptureGraphBuilder2::RenderStream
• ICaptureGraphBuilder2::SetFiltergraph
• ICaptureGraphBuilder2::SetOutputFileName

Este método incrementa el recuento de referencias en la interfaz IGraphBuilder . Asegúrese de liberar la interfaz cuando haya terminado con ella.

Requisitos

Requisito	Value
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

ICaptureGraphBuilder2 (Interfaz)