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

Метод IVMRMixerBitmap::SetAlphaBitmap (strmif.h)

  • Статья

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

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

Синтаксис

HRESULT SetAlphaBitmap(
  [in] const VMRALPHABITMAP *pBmpParms
);

Параметры

[in] pBmpParms

Указатель на структуру VMRALPHABITMAP , содержащую сведения о растровом рисунке.

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

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

Код возврата Описание
E_POINTER
 pBmpParms имеет значение NULL.
E_INVALIDARG
 Недопустимый аргумент. См. заметки.
E_OUTOFMEMORY
 Не удалось создать целевой контроллер домена или DIBSection для растрового изображения.
E_FAIL
 Не удалось выполнить bitBlt для поверхности растрового изображения.

Комментарии

Чтобы удалить растровое изображение, задайте структуру VMRALPHABITMAP и снова вызовите SetAlphaBitmap .

Метод может возвращать E_INVALIDARG по нескольким причинам:

    [VMRALPHABITMAP] Структура (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) содержит недопустимое сочетание флагов. [VMRALPHABITMAP] В структуре (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) не указана допустимая поверхность HDC или DirectDraw.
  • Недопустимое значение fAlpha .

Требования

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

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

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

Интерфейс IVMRMixerBitmap

IVMRMixerBitmap::GetAlphaBitmapParameters

Использование отрисовщика смешанного видео

Фильтр 7 отрисовщика микширования видео