Метод IOverlay::GetClipList (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод GetClipList извлекает список обрезки.
Синтаксис
HRESULT GetClipList(
[out] RECT *pSourceRect,
[in] RECT *pDestinationRect,
[out] RGNDATA **ppRgnData
);
Параметры
[out] pSourceRect
Указатель на ограничивающий клиентский прямоугольник.
[in] pDestinationRect
Указатель на прямоугольник назначения.
[out] ppRgnData
Адрес указателя на заголовок и данные, описывающие вырезку. В случае успешного выполнения освободите выделенную память, вызвав CoTaskMemFree.
Возвращаемое значение
В случае успешного выполнения возвращает S_OK. Если метод завершается сбоем, он возвращает код ошибки HRESULT .
Комментарии
Реализация IOverlay выделяет память для прямоугольников обрезки, так как она может отличаться по длине. Фильтр, вызывающий этот метод, должен освободить память (с помощью CoTaskMemFree) после завершения работы с ней.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |