Метод IPin::BeginFlush (strmif.h)

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод BeginFlush начинает операцию очистки.

Приложения не должны вызывать этот метод. Этот метод вызывается другими фильтрами для очистки данных из графа.

Синтаксис

HRESULT BeginFlush();

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
S_OK
 Успешно.
E_UNEXPECTED
 Закрепление является выходным закреплением.

Комментарии

Вызовите этот метод только для входных контактов. Выходные контакты возвращают E_UNEXPECTED.

В операции очистки фильтр удаляет все обрабатываемые данные. Новые данные отклоняются до завершения очистки. Очистка завершается, когда вышестоящий закрепления вызывает метод IPin::EndFlush. Очистка позволяет графу фильтров лучше реагировать, когда события изменяют обычный поток данных. Например, очистка происходит во время поиска.

При BeginFlush вызове фильтр выполняет следующие действия:

  1. Передает подчиненный IPin::BeginFlush вызов.
  2. Задает внутренний флаг, вызывающий сбой всех методов потоковой передачи данных, например IMemInputPin::Receive.
  3. Возвращает данные из всех заблокированных вызовов метода Receive .
BeginFlush Когда уведомление достигает фильтра отрисовщика, отрисовщик освобождает все образцы, которые он хранит.

После BeginFlush вызова закрепление отклоняет все образцы из вышестоящий с возвращаемым значением S_FALSE, пока не будет вызван метод IPin::EndFlush.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Поток данных в графе фильтров

Коды ошибок и успешного выполнения

Интерфейс IPin