Метод IMFSourceReader::Flush (mfreadwrite.h)

Сбрасывает один или несколько потоков.

Синтаксис

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Параметры

[in] dwStreamIndex

Поток для очистки. Значением может быть любое из следующих значений.

Значение Значение
0–0xFFFFFFFB
Отсчитываемый от нуля индекс потока.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
Первый видеопоток.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
Первый аудиопоток.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
Все потоки.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Метод Flush отменяет все образцы, помещенные в очередь, и отменяет все ожидающие запросы примеров.

Этот метод может выполняться синхронно или асинхронно.

Если при создании исходного средства чтения указан указатель обратного вызова, метод будет асинхронным. В противном случае метод является синхронным. Дополнительные сведения о настройке указателя обратного вызова см. в разделе MF_SOURCE_READER_ASYNC_CALLBACK.

В синхронном режиме метод блокируется до завершения операции.

В асинхронном режиме метод ПРИЛОЖЕНИЯ IMFSourceReaderCallback::OnFlush вызывается по завершении операции очистки. Пока операция очистки находится в состоянии ожидания, метод IMFSourceReader::ReadSample возвращает MF_E_NOTACCEPTING.

Примечание В Windows 7 в реализации этого метода возникла ошибка, из-за которой onFlush вызывается до завершения операции очистки. Раньше было доступно исправление, которое исправит ошибку.
 
Этот интерфейс доступен в Windows Vista, если установлено дополнение к обновлению платформы для Windows Vista.

Требования

Требование Значение
Минимальная версия клиента Дополнение к Windows 7, Windows Vista и обновлению платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfreadwrite.h

См. также раздел

IMFSourceReader

Средство чтения исходного кода