Поделиться через

Метод CPullPin.OnError

  • Статья

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

Метод OnError вызывается, если во время потоковой передачи возникает ошибка. Производный класс должен реализовывать этот метод.

Синтаксис

virtual void OnError(
   HRESULT hr
) = 0;

Параметры

ч

Задает значение HRESULT , возвращаемое методом, завершившемся сбоем.

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

Этот метод не возвращает значение.

Комментарии

Объект вызывает этот метод всякий раз, когда возникает ошибка, которая останавливает поток, извлекающий данные. Фильтр может использовать этот метод для корректного восстановления после ошибок потоковой передачи. В большинстве случаев ошибка возвращается из фильтра вышестоящий, поэтому вышестоящий фильтр отвечает за ее отправку в диспетчер фильтров Graph. Если ошибка возникает в методе CPullPin::Receive , фильтр должен отправить событие EC_ERRORABORT . (См. раздел IMediaEventSink::Notify.)

Требования

Требование Значение
Заголовок
Pullpin.h
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CPullPin