Метод IBasicVideo::p ut_SourceTop (control.h)

  • Статья

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

Метод put_SourceTop задает координату Y исходного прямоугольника.

Синтаксис

HRESULT put_SourceTop(
  [in] long SourceTop
);

Параметры

[in] SourceTop

Задает координату Y в пикселях.

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

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

Код возврата Описание
E_INVALIDARG
 Недопустимый аргумент.
S_OK
 Успешно.
VFW_E_NOT_CONNECTED
 Входной контакт видео отрисовщика не подключен.

Комментарии

Этот метод перемещает весь исходный прямоугольник вверх или вниз. Высота исходного прямоугольника не изменяется. Если значение SourceTop помещит нижний край прямоугольника за край видеокадра, метод возвращает E_INVALIDARG. Чтобы обрезать видео, вызовите put_SourceHeight , чтобы настроить ширину, прежде чем вызывать put_SourceTop. (Или вызовите SetSourcePosition , чтобы задать весь исходный прямоугольник одновременно.)

Требования

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

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

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

Интерфейс IBasicVideo