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


EC_COMPLETE

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

Все данные из определенного потока были отрисованы.

Параметры

lParam1

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

lParam2

(IUnknown*) Ноль или указатель на интерфейс IBaseFilter отрисовщика.

Действие по умолчанию

По умолчанию диспетчер графов фильтров не пересылает это событие в приложение. Однако после того, как все потоки в графовом отчете EC_COMPLETE, диспетчер графа фильтра отправляет в приложение отдельное событие EC_COMPLETE .

Если для этого события отключено действие по умолчанию, приложение получает от отрисовщиков все события EC_COMPLETE .

Комментарии

Фильтр отрисовщика отправляет это событие при получении уведомления об окончании потока. (Сигнал о конце потока передается с помощью метода IPin::EndOfStream .) Фильтр отправляет ровно одно событие EC_COMPLETE для каждого потока. Перед отправкой события фильтр должен обработать все ожидающие выборки. При остановке отрисовщика сбрасывается любое кэшированное состояние конца потока.

Если отрисовщик приостановлен, он не отправляет EC_COMPLETE до вызова метода IMediaFilter::Run . Кроме того, он продолжает отправлять события EC_COMPLETE для каждого перехода от приостановки к выполнению, пока фильтр не будет остановлен или удален.

Фильтры устанавливают для параметра lParam2 указатель IBaseFilter . Если действие по умолчанию включено, диспетчер графов фильтров устанавливает для этого параметра нулевое значение.

Требования

Требование Значение
Заголовок
Dshow.h

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

Коды уведомлений о событиях

Уведомление о событиях в DirectShow

Альтернативные отрисовщики видео