Метод 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. В противном случае функция возвращает код ошибки.
| Код возврата | Описание |
|---|---|
|
pBmpParms имеет значение NULL. |
|
Недопустимый аргумент. См. заметки. |
|
Не удалось создать целевой контроллер домена или DIBSection для растрового изображения. |
|
Не удалось выполнить 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::GetAlphaBitmapParameters