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


Метод CBaseControlVideo.GetDestinationPosition

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

Метод GetDestinationPosition извлекает прямоугольник назначения в одной атомарной операции.

Синтаксис

HRESULT GetDestinationPosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Параметры

pLeft

Указатель на левую координату прямоугольника назначения.

pTop

Указатель на верхнюю координату прямоугольника назначения.

pWidth

Указатель на ширину прямоугольника назначения.

pHeight

Указатель на высоту прямоугольника назначения.

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

Возвращает значение HRESULT , которое зависит от реализации; Может быть одним из следующих значений или другими значениями, не указанными в списке.

Код возврата Описание
E_FAIL
Ошибка.
E_POINTER
Аргумент указателя NULL.
VFW_E_NOT_CONNECTED
Невозможно выполнить операцию, так как контакты не подключены.
NOERROR
Успешно.

Комментарии

Эту функцию-член можно использовать вместо отдельных вызовов функций-членов CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth и CBaseControlVideo::get_DestinationHeight . Приложение может изменять исходный и целевой прямоугольники для видео с помощью интерфейса IBasicVideo . Исходный прямоугольник влияет на то, какой раздел собственного источника видео будет отображаться на экране; прямоугольник назначения влияет на место отображения видео при воспроизведении. Прямоугольник назначения относится к клиентской области окна, в котором он воспроизводит. Левый верхний угол окна — координата (0,0).

Требования

Требование Значение
Заголовок
Ctlutil.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CBaseControlVideo