Compartilhar via

Método IMFSourceReader::Flush (mfreadwrite.h)

  • Artigo

Libera um ou mais fluxos.

Sintaxe

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Parâmetros

[in] dwStreamIndex

O fluxo a ser liberado. O valor pode ser qualquer um dos seguintes.

Valor Significado
0 a 0xFFFFFFFB
 O índice baseado em zero de um fluxo.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 O primeiro fluxo de vídeo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 O primeiro fluxo de áudio.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
 Todos os fluxos.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O método Flush descarta todos os exemplos na fila e cancela todas as solicitações de exemplo pendentes.

Esse método pode ser concluído de forma síncrona ou assíncrona.

Se você fornecer um ponteiro de retorno de chamada ao criar o leitor de origem, o método será assíncrono. Caso contrário, o método será síncrono. Para obter mais informações sobre a configuração do ponteiro de retorno de chamada, consulte MF_SOURCE_READER_ASYNC_CALLBACK.

No modo síncrono, o método é bloqueado até que a operação seja concluída.

No modo assíncrono, o método IMFSourceReaderCallback::OnFlush do aplicativo é chamado quando a operação de liberação é concluída. Enquanto uma operação de liberação está pendente, o método IMFSourceReader::ReadSample retorna MF_E_NOTACCEPTING.

Nota No Windows 7, houve um bug na implementação desse método, o que faz com que o OnFlush seja chamado antes da conclusão da operação de liberação. Um hotfix usado para estar disponível que corrigiu esse bug.
 
Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfreadwrite.h

Confira também

IMFSourceReader

Leitor de origem