Compartir a través de


Método CTransInPlaceFilter.CompleteConnect

[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 CompleteConnect método completa una conexión de patilla.

Sintaxis

HRESULT CompleteConnect(
   PIN_DIRECTION direction,
   IPin          *pReceivePin
);

Parámetros

direction

Miembro del PIN_DIRECTION tipo enumerado, especificando qué pin del filtro está realizando la conexión.

pReceivePin

Puntero a la interfaz IPin del otro pin en este intento de conexión.

Valor devuelto

Devuelve un VALOR HRESULT. Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.

Código devuelto Descripción
S_OK
Correcto.
VFW_E_NOT_IN_GRAPH
El filtro no está en un gráfico de filtros.

Observaciones

Este método invalida el método CTransformFilter::CompleteConnect .

El comportamiento del filtro depende del orden de las conexiones pin:

  • Si el pin de entrada está conectado primero, la conexión usa un asignador temporal. Cuando el pin de salida está conectado, el filtro vuelve a conectar el pin de entrada. La reconexión del pin de entrada hace que el filtro ascendente renegocia el asignador. En ese momento, el pin de entrada propone un asignador del filtro de bajada. Para obtener más información, vea CTransInPlaceInputPin::GetAllocator.
  • Si el pin de salida está conectado primero, el pin de salida no selecciona un asignador. Cuando el pin de entrada está conectado, negocia un asignador para ambas conexiones. Si los tipos de medios de entrada y salida no son los mismos, el filtro vuelve a conectar el pin de salida mediante el tipo de entrada.

El filtro realiza todas las reconexión de patillas mediante una llamada al método CBaseFilter::ReconnectPin . El método ReconnectPin , a su vez, llama al método IFilterGraph2::ReconnectEx en el administrador de gráficos de filtros.

Requisitos

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

Consulte también

CTransInPlaceFilter (clase)