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

Метод IDDrawExclModeVideoCallback::OnUpdateOverlay (strmif.h)

  • Статья

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

Метод OnUpdateOverlay информирует приложение о том, что поверхность наложения для видео станет видимой, невидимой, изменится размер или положение, чтобы приложение о 1000000 параметров соответствующих параметров перекрасилось в окно.

Синтаксис

HRESULT OnUpdateOverlay(
  [in] BOOL       bBefore,
  [in] DWORD      dwFlags,
  [in] BOOL       bOldVisible,
  [in] const RECT *prcOldSrc,
  [in] const RECT *prcOldDest,
  [in] BOOL       bNewVisible,
  [in] const RECT *prcNewSrc,
  [in] const RECT *prcNewDest
);

Параметры

[in] bBefore

Логическое значение, указывающее, выполняется ли вызов до или после изменения, связанного с наложением. Значение TRUE указывает before, FALSE — после.

[in] dwFlags

Значение из перечисления AM_OVERLAY_NOTIFY_FLAGS , указывающее, что изменится или что изменится.

[in] bOldVisible

Логическое значение, указывающее, отображается ли старое окно. Значение TRUE означает, что старое окно отображается.

[in] prcOldSrc

Указатель на прямоугольник, представляющий старое исходное положение поверхности DirectDraw.

[in] prcOldDest

Указатель на прямоугольник, представляющий старое расположение прямоугольника на поверхности наложения.

[in] bNewVisible

Логическое значение, указывающее, отображается ли новое окно. Значение TRUE означает, что новое окно отображается.

[in] prcNewSrc

Указатель на прямоугольник, представляющий новое исходное положение поверхности DirectDraw.

[in] prcNewDest

Указатель на прямоугольник, представляющий новое целевое положение прямоугольника на поверхности наложения.

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

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

Код возврата Описание
S_OK
 Успешно.
E_INVALIDARG
 Недопустимый параметр.

Комментарии

Приложение должно вызывать этот метод один раз до изменения, связанного с наложением, и один раз после внесения изменений. В вызове перед изменением изменение наложения не происходит, пока приложение не завершит выполнение этого метода.

Требования

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

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

Коды ошибок и успешности

Интерфейс IDDrawExclModeVideoCallback