Метод IDDrawExclModeVideoCallback::OnUpdateColorKey (strmif.h)

Статья
07/28/2023

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

Метод OnUpdateColorKey информирует приложение о том, что ключ цвета изменился, чтобы приложение пользовалось новым цветом для наложения графики на видео.

Синтаксис

HRESULT OnUpdateColorKey(
  [out] const COLORKEY *pKey,
  [out] DWORD          dwColor
);

Параметры

[out] pKey

Указатель на структуру COLORKEY , содержащую тип ключа и индекс палитры.

[out] dwColor

Значение, указывающее 8-разрядный индекс палитры COLORKEY , возвращаемого в pKey, если текущий режим отображения является 8-разрядным. В противном случае это значение, представляющее ключ цвета в формате пикселей текущего режима отображения.

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

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

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Один из параметров является недопустимым.

Требования


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

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

Коды ошибок и успешности

Интерфейс IDDrawExclModeVideoCallback

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