Compartir a través de


Método IGraphBuilder::Connect (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 Connect método conecta los dos pines, utilizando intermedios si es necesario.

Sintaxis

HRESULT Connect(
  [in] IPin *ppinOut,
  [in] IPin *ppinIn
);

Parámetros

[in] ppinOut

Puntero a la interfaz IPin en el pin de salida.

[in] ppinIn

Puntero a la interfaz IPin en el pin de entrada.

Valor devuelto

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

Código devuelto Descripción
S_OK
Correcto.
VFW_S_PARTIAL_RENDER
Éxito parcial; algunas de las secuencias de este pin usan un formato no admitido.
E_ABORT
La operación se anuló.
E_POINTER
Argumento de puntero NULL.
VFW_E_CANNOT_CONNECT
No se encontró ninguna combinación de filtros intermedios para establecer la conexión.
VFW_E_NOT_IN_GRAPH
Al menos uno de los filtros no está en el gráfico de filtros.

Comentarios

Este método conecta dos patillas directa o indirectamente, agregando filtros intermedios si es necesario. El método comienza intentando una conexión directa. Si se produce un error, intenta usar los filtros que ya están en el gráfico de filtros y tienen patillas de entrada no conectadas. (Enumera esto en un orden arbitrario). Si se produce un error, busca filtros en el registro y los intenta en orden de mérito. Para obtener más información, consulte Intelligent Connect.

Durante el proceso de conexión, el Administrador de gráficos de filtros omite las patillas de los filtros intermedios si el nombre del pin comienza con una tilde (~). Para obtener más información, consulte PIN_INFO.

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

IGraphBuilder (interfaz)