Compartilhar via

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

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.

Value Meaning
0–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.

Valor de retorno

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

Observações

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, que faz com que o OnFlush seja chamado antes da conclusão da operação de liberação. Um hotfix costumava estar disponível que corrigia esse bug.
 
Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requirements

Requirement Value
Cliente mínimo suportado Suplemento windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header mfreadwrite.h

Consulte também

IMFSourceReader

Leitor de origem

  • Last updated on