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

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

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

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

Синтаксис

HRESULT BeginFlush();

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

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

Комментарии

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

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

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

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

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

Требования

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

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

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

Интерфейс IPin