Método IPin::BeginFlush (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O BeginFlush método inicia uma operação de liberação.

Os aplicativos não devem chamar esse método. Esse método é chamado por outros filtros para liberar dados do grafo.

Sintaxe

HRESULT BeginFlush();

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Comentários

Chame esse método somente em pinos de entrada. Os pinos de saída retornam E_UNEXPECTED.

Em uma operação de liberação, um filtro descarta os dados que estava processando. Ele rejeita novos dados até que a liberação seja concluída. A liberação é concluída quando o upstream pin chama o método IPin::EndFlush. A liberação permite que o grafo de filtro seja mais responsivo quando os eventos alteram o fluxo de dados normal. Por exemplo, a liberação ocorre durante uma busca.

Quando BeginFlush é chamado, o filtro executa as seguintes etapas:

1. Passa a IPin::BeginFlush chamada downstream.
2. Define um sinalizador interno que faz com que todos os métodos de streaming de dados falhem, como IMemInputPin::Receive.
3. Retorna de todas as chamadas bloqueadas para o método Receive .

Depois BeginFlush de ser chamado, o pino rejeita todas as amostras de upstream, com um valor retornado de S_FALSE, até que o método IPin::EndFlush seja chamado.

Requisitos

Confira também

Fluxo de Dados no Grafo de Filtro

Códigos de erro e êxito

IPin Interface