Método IPinConnection::D ynamicDisconnect (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 DynamicDisconnect método desconecta el pin cuando el filtro está activo (en pausa o en ejecución). Llame a este método en lugar de IPin::D isconnect para desconectar un pin cuando el grafo se esté ejecutando o en pausa.

El autor de la llamada debe asegurarse de que ningún dato fluya al pin cuando llame a este método. Llame al método IPinFlowControl::Block en una patilla ascendente para bloquear el flujo de datos o use algún otro mecanismo para asegurarse de que no se entreguen muestras hasta que se vuelva a conectar este pin.

Sintaxis

HRESULT DynamicDisconnect();

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto	Descripción
S_FALSE	El pin ya está desconectado.
S_OK	Correcto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Reconexión dinámica

Códigos de error y éxito

IPinConnection (interfaz)