Método CBasePin.GetConnected

  • 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 GetConnected método recupera el pin conectado a este pin.

Sintaxis

IPin* GetConnected();

Parámetros

Este método no tiene parámetros.

Valor devuelto

Devuelve un puntero a la interfaz IPin del otro pin.

Observaciones

Si el pin no está conectado, este método devuelve NULL. Llame al método CBasePin::IsConnected para determinar si el pin está conectado.

El método no llama a AddRef en la interfaz IPin , por lo que el autor de la llamada no debe liberar la interfaz.

Ejemplos

Dado que el recuento de referencias no se incrementa en el puntero devuelto, puede encadenar llamadas de método juntas:

if (m_MyPin->IsConnected())
{
    m_MyPin->GetConnected()->EndOfStream();
}

Este patrón de codificación es muy conveniente; pero como se muestra en el ejemplo, debe tener cuidado de no desreferenciar un puntero NULL cuando la patilla no está conectada.

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)