Метод IOverlayNotify::OnClipChange (strmif.h)

Статья
07/28/2023

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

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

Синтаксис

HRESULT OnClipChange(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestinationRect,
  [in] const RGNDATA *pRgnData
);

Параметры

[in] pSourceRect

Указатель на область используемого видео.

[in] pDestinationRect

Указатель на место назначения видео.

[in] pRgnData

Указатель на сведения об обрезки.

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

В случае успешного выполнения возвращает S_OK. Если метод завершается сбоем, он возвращает код ошибки HRESULT .

Вызовы, которые должны выполняться OnClipChange в синхронизации с окном. Он вызывается с пустым списком клипов, чтобы заморозить видео перед перемещением окна, а затем снова вызывается, когда окно стабилизируется с новым списком клипов.

Если прямоугольник окна равен нулям, окно невидимо. Как и в случае с декодерами AVI, декодер должен сохранить изображение, если он использует текущее изображение для декодирования следующего.

Требования


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

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

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

Интерфейс IOverlayNotify

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