Метод IVideoWindow::p ut_BackgroundPalette (control.h)

  • Статья

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

Метод put_BackgroundPalette указывает, реализует ли окно видео свою палитру в фоновом режиме.

Синтаксис

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Параметры

[in] BackgroundPalette

Указывает, реализует ли отрисовщик видео палитру в фоновом режиме. Необходимо установить одно из следующих значений.

Значение Описание
ОАТРУЕ Отрисовщик видео реализует палитру в фоновом режиме.
OAFALSE Отрисовщик видео не реализует палитру в фоновом режиме. (по умолчанию).

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

Возможные возвращаемые значения:

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

Комментарии

Если backgroundPalette имеет значение OATRUE , а видеоизобику требуется палитра, отрисовщик видео будет понимать, что палитра находится в фоновом режиме. Все цвета, которые используются в палитре, будут изменены на их ближайшее соответствие в палитре отображения перед рисованием. Это гарантирует, что палитра приложения не будет нарушена. Тем не менее, это накладывает серьезные штрафы за производительность на видео.

Требования

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

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

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

Интерфейс IVideoWindow

IVideoWindow::get_BackgroundPalette