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

Структура VMRALPHABITMAP (strmif.h)

  • Статья

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

Структура VMRALPHABITMAP используется в методах IVMRMixerBitmap фильтра VMR-7, когда приложение предоставляет статическое альфа-смешиваемое растровое изображение для отображения в составном видеокадре.

Синтаксис

typedef struct _VMRALPHABITMAP {
  DWORD                dwFlags;
  HDC                  hdc;
  LPDIRECTDRAWSURFACE7 pDDS;
  RECT                 rSrc;
  NORMALIZEDRECT       rDest;
  FLOAT                fAlpha;
  COLORREF             clrSrcKey;
} VMRALPHABITMAP, *PVMRALPHABITMAP;

Члены

dwFlags

Флаги, указывающие микшеру, где найти растровое изображение. Определены следующие значения.

Значение Значение
VMRBITMAP_DISABLE
0x00000001
 Отключите растровое изображение. Этот флаг нельзя сочетать с другими флагами.
VMRBITMAP_HDC
0x00000002
 Получите растровое изображение из HDC. Если этот флаг установлен, член HDC должен указать допустимый дескриптор для контекста устройства, а элемент pDDS должен иметь значение NULL.

Если этот флаг отсутствует, элемент pDDS должен указывать на допустимую поверхность DirectDraw, а элемент HDC должен иметь значение NULL.
VMRBITMAP_ENTIREDDS
0x00000004
 Возьмем всю поверхность DirectDraw. Если этот флаг указан, rSrc игнорируется. Этот флаг нельзя сочетать с флагом VMRBITMAP_HDC .
VMRBITMAP_SRCCOLORKEY
0x00000008
 Значение clrSrcKey является допустимым и должно использоваться при наложении.
VMRBITMAP_SRCRECT
0x00000010
 Указывает, что прямоугольник rSrc является допустимым, и указывает вложенный прямоугольник исходного изображения приложения для смешивания.

Этот флаг действителен только для метода IVMRMixerBitmap::UpdateAlphaBitmapParameters . Для метода IVMRMixerBitmap::SetAlphaBitmap член rSrc должен ссылаться на все растровое изображение.

hdc

Дескриптор контекста устройства для растрового изображения. Укажите ЗНАЧЕНИЕ NULL , если растровое изображение находится в области DirectDraw.

pDDS

Указатель на поверхность DirectDraw, содержащую растровое изображение. Укажите ЗНАЧЕНИЕ NULL , если растровое изображение должно быть получено из контекста устройства GDI. Если указана поверхность DirectDraw, формат пикселей должен быть ARGB-32 или RGB-32. Если поверхность содержит альфа-канал для каждого пикселя, не устанавливайте флаг VMRBITMAP_SRCCOLORKEY в dwFlags.

rSrc

Задает исходный прямоугольник в контексте устройства GDI или в области DirectDraw.

rDest

Задает прямоугольник назначения в пространстве композиции.

fAlpha

Указывает значение альфа-смешивания; значение должно быть от 0,0 до 1,0 (включительно).

clrSrcKey

Задает ключ цвета источника.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть strmif.h (включая Dshow.h)

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

Структуры DirectShow