Метод 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 . Ниже приведены возможные значения.

Комментарии

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

Требования

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

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

Интерфейс IBasicVideo