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


Метод IOverlay::GetDefaultColorKey (strmif.h)

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

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

Синтаксис

HRESULT GetDefaultColorKey(
  [out] COLORKEY *pColorKey
);

Параметры

[out] pColorKey

Указатель на переменную, получающую цветовую клавишу по умолчанию.

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

В случае успешного выполнения возвращает S_OK. Если метод завершается сбоем, он возвращает код ошибки HRESULT .

Комментарии

Фильтр, использующий цветовые клавиши, может получить цвет по умолчанию из отрисовщика видео. Затем цветовой ключ по умолчанию можно установить в окно с помощью IOverlay::SetColorKey. Цвета, возвращаемые этим методом, зависят от текущего режима отображения. Если цвета являются 8-разрядными, они будут яркими системными цветами (например, пурпурной). Если дисплей находится в режиме true-color, они будут иметь оттенки черного.

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

Требования

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

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

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

Интерфейс IOverlay