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

Метод IMixerPinConfig::GetColorKey (mpconfig.h)

  • Статья

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

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

Синтаксис

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

Параметры

[out] pColorKey

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

[out] pColor

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

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

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

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

Комментарии

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

Текущая реализация DirectShow этого интерфейса может возвращать значение NULL для параметров pColorKey или pColor ; однако метод завершится ошибкой и вернет E_INVALIDARG, если оба параметра имеют значение NULL.

Примечание Значение DWORD , возвращаемое параметром pColor , является фактическим используемым цветом. Таким образом, если битовая глубина отображения составляет 8, 16, 24, 32, последние 8, 16, 24 или 32 бит DWORD укажите фактическое значение клавиши цвета.
 

Требования

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

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

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

Интерфейс IMixerPinConfig

IMixerPinConfig::SetColorKey