Método IMediaControl::Stop (control.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 Stop método detiene todos los filtros del gráfico.

Sintaxis

HRESULT Stop();

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o un valor HRESULT que indica la causa del error.

Comentarios

Si el grafo se está ejecutando, este método pausa el gráfico antes de detenerlo. Mientras está en pausa, los representadores de vídeo pueden copiar el fotograma actual para mostrarse como marco de póster.

Este método no busca el principio de la secuencia. Si llama a este método y, a continuación, llama al método IMediaControl::Run , la reproducción se reanuda desde la posición detenida. Para buscar, use la interfaz IMediaSeeking .

El Administrador de gráficos de filtros pausa todos los filtros del gráfico y, a continuación, llama al método IMediaFilter::Stop en todos los filtros, sin esperar a que se completen las operaciones de pausa. Por lo tanto, es posible que algunos filtros tengan su Stop método llamado antes de completar su operación de pausa. Si desarrolla un filtro de representación personalizado, es posible que tenga que controlar este caso pausando el filtro si recibe un comando stop mientras está en estado de ejecución. Sin embargo, la mayoría de los filtros no necesitan realizar ninguna acción especial en este sentido.

Requisitos

Consulte también

Códigos de error y éxito

IMediaControl (interfaz)

StopWhenReady