Método IPin::BeginFlush (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 BeginFlush método inicia una operación de vaciado.

Las aplicaciones no deben llamar a este método. Otros filtros llaman a este método para vaciar los datos del grafo.

Sintaxis

HRESULT BeginFlush();

Valor devuelto

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

Código devuelto	Descripción
S_OK	Correcto.
E_UNEXPECTED	El pin es un pin de salida.

Comentarios

Llame a este método solo en patillas de entrada. Los pines de salida devuelven E_UNEXPECTED.

En una operación de vaciado, un filtro descarta los datos que estaba procesando. Rechaza los nuevos datos hasta que se completa el vaciado. El vaciado se completa cuando el pin ascendente llama al método IPin::EndFlush . El vaciado permite que el gráfico de filtros tenga mayor capacidad de respuesta cuando los eventos modifican el flujo de datos normal. Por ejemplo, el vaciado se produce durante una búsqueda.

Cuando BeginFlush se llama a , el filtro realiza los pasos siguientes:

1. Pasa la IPin::BeginFlush llamada de bajada.
2. Establece una marca interna que hace que se produzca un error en todos los métodos de streaming de datos, como IMemInputPin::Receive.
3. Devuelve desde las llamadas bloqueadas al método Receive .

Cuando la BeginFlush notificación alcanza un filtro de representador, el representador libera los ejemplos que contiene.

Después BeginFlush de llamar a , el pin rechaza todas las muestras de nivel superior, con un valor devuelto de S_FALSE, hasta que se llama al método IPin::EndFlush .

Requisitos

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

Consulte también

Data Flow en el gráfico de filtros

Códigos de error y éxito

IPin (interfaz)