Método CBasePin.Connect

  • 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 Connect método conecta el pin a otro pin. Este método implementa el método IPin::Connect .

Sintaxis

HRESULT Connect(
         IPin          *pReceivePin,
   const AM_MEDIA_TYPE *pmt
);

Parámetros

pReceivePin

Puntero a la interfaz IPin del pin receptor.

Pmt

Puntero a una estructura de AM_MEDIA_TYPE que especifica el tipo de medio para la conexión.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles se incluyen los de la tabla siguiente.

Código devuelto Descripción
S_OK
 Correcto.
VFW_E_ALREADY_CONNECTED
 El pin ya está conectado.
VFW_E_NO_ACCEPTABLE_TYPES
 No se pudo encontrar un tipo de medio aceptable.
VFW_E_NOT_STOPPED
 El filtro está activo y la patilla no admite la reconexión dinámica.
VFW_E_TYPE_NOT_ACCEPTED
 El tipo de medio especificado no es aceptable.

Observaciones

El parámetro pmt puede ser NULL. También puede especificar un tipo de medio parcial, con un valor de GUID_NULL para el tipo principal, subtipo o formato.

En la clase base, este método comprueba si el pin ya está conectado y si el filtro está detenido. Delega el resto del proceso de conexión al método CBasePin::AgreeMediaType .

Requisitos

Requisito Value
Encabezado
Amfilter.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBasePin (clase)