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


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

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

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

Синтаксис

HRESULT put_SourceLeft(
  [in] long SourceLeft
);

Параметры

[in] SourceLeft

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

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

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

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

Комментарии

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

Требования

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

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

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

Интерфейс IBasicVideo