Método IPin::ReceiveConnection (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 ReceiveConnection método acepta una conexión de otro pin.

Las aplicaciones no deben llamar a este método. Otros filtros llaman a este método durante el proceso de conexión de patillas.

Sintaxis

HRESULT ReceiveConnection(
  [in] IPin                *pConnector,
  [in] const AM_MEDIA_TYPE *pmt
);

Parámetros

[in] pConnector

Puntero a la interfaz IPin del pin de conexión.

[in] 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 . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Argumento de puntero NULL.
VFW_E_ALREADY_CONNECTED
 El pin ya está conectado.
VFW_E_NOT_STOPPED
 No se puede conectar mientras el filtro está activo.
VFW_E_TYPE_NOT_ACCEPTED
 El tipo de medio especificado no es aceptable.

Observaciones

Cuando se conecta un pin de salida, llama a este método en el pin de entrada. El pin de entrada debe comprobar que el tipo de medio especificado es aceptable. También puede que tenga que comprobar otros requisitos de conexión específicos del filtro propietario. Si la conexión es adecuada, el pin de entrada debe devolver S_OK y también hacer lo siguiente:

Si la conexión no es adecuada, el pin debe devolver un código de error.

La clase CBasePin implementa el marco básico para este método, incluido el almacenamiento del tipo de medio y los punteros IPin .

Requisitos

   
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

Conexión de filtros

IPin (interfaz)