Метод IOverlayNotify::OnClipChange (strmif.h)
[Функция, связанная с этой страницей 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 |