Método IPin::ReceiveConnection (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 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 |
|---|---|
|
Correcto. |
|
Argumento de puntero NULL. |
|
El pin ya está conectado. |
|
No se puede conectar mientras el filtro está activo. |
|
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:
- Almacene el tipo de medio y devuelva el mismo tipo en el método IPin::ConnectionMediaType .
- Almacene la interfaz IPin del pin de salida (pConnector) y devuelva este puntero en el método IPin::ConnectedTo .
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 |