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


Метод CBaseControlWindow.get_BorderColor

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

Метод get_BorderColor извлекает текущий цвет границы.

Синтаксис

HRESULT get_BorderColor(
   long *Color
);

Параметры

Цвет

Указатель на текущий цвет границы.

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

Возвращает значение HRESULT .

Комментарии

Приложение может задать целевой прямоугольник, в котором должно отображаться видео. Этот прямоугольник относится к клиентской области окна. Если это делается (по умолчанию всегда закрашивать все окно), вокруг видео будет граница. Это свойство влияет на цвет, используемый границей. Хотя параметр указан как тип LONG , на самом деле это значение COLORREF .

Эта функция-член предназначена для вызова внешними объектами через интерфейс IVideoWindow и, следовательно, блокирует критически важный раздел для синхронизации со связанным фильтром. Вызовите функцию-член CBaseControlWindow::GetBorderColour , чтобы получить это свойство, если не вызывается из внешнего объекта.

Требования

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

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

Класс CBaseControlWindow