Método CBasePin.BreakConnect

  • 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 BreakConnect método libera el pin de una conexión.

Sintaxis

virtual HRESULT BreakConnect();

Parámetros

Este método no tiene parámetros.

Valor devuelto

Devuelve S_OK.

Comentarios

El método CBasePin::D isconnect llama a este método durante la desconexión de patillas. También se llama durante un intento de conexión si se produce un error en el método CBasePin::CheckConnect .

Este método debe liberar los recursos obtenidos por el método CheckConnect . Por ejemplo, si CheckConnect asigna memoria, BreakConnect debe liberar la memoria. Si CheckConnect consulta el pin de conexión de una interfaz, BreakConnect debe liberar la interfaz.

Tenga en cuenta que BreakConnect se puede llamar sin una llamada correspondiente a CompleteConnect. Por lo tanto, no se puede suponer que se ha llamado previamente a CompleteConnect .

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)