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.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
O pino é um pino de saída. |
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:
- Passa a
IPin::BeginFlushchamada downstream. - Define um sinalizador interno que faz com que todos os métodos de streaming de dados falhem, como IMemInputPin::Receive.
- Retorna de todas as chamadas bloqueadas para o método Receive .
BeginFlush notificação atinge um filtro de renderizador, o renderizador libera todos os exemplos que contém.
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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |