VMRALPHABITMAP-Struktur (strmif.h)

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die VMRALPHABITMAP-Struktur wird in den IVMRMixerBitmap-Methoden des VMR-7-Filters verwendet, wenn die Anwendung eine statische Alpha-gemischte Bitmap bereitstellt, die im zusammengesetzten Videoframe angezeigt werden soll.

Syntax

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

Member

dwFlags

Flags, die den Mixer anweisen, wo die Bitmap zu finden ist. Die folgenden Werte werden definiert.

Wert	Bedeutung
VMRBITMAP_DISABLE 0x00000001	Deaktivieren Sie die Bitmap. Dieses Flag kann nicht mit anderen Flags kombiniert werden.
VMRBITMAP_HDC 0x00000002	Rufen Sie die Bitmap aus dem HDC ab. Wenn dieses Flag festgelegt ist, muss das hdc-Element ein gültiges Handle für einen Gerätekontext angeben, und das pDDS-Element muss NULL sein. Wenn dieses Flag nicht vorhanden ist, muss das pDDS-Element auf eine gültige DirectDraw-Oberfläche zeigen, und das hdc-Element muss NULL sein.
VMRBITMAP_ENTIREDDS 0x00000004	Verwenden Sie die gesamte DirectDraw-Oberfläche. Wenn dieses Flag angegeben wird, wird rSrc ignoriert. Dieses Flag kann nicht mit dem VMRBITMAP_HDC-Flag kombiniert werden.
VMRBITMAP_SRCCOLORKEY 0x00000008	Der clrSrcKey-Wert ist gültig und sollte beim Mischen verwendet werden.
VMRBITMAP_SRCRECT 0x00000010	Gibt an, dass das rSrc-Rechteck gültig ist, und gibt ein Unterrechteck des ursprünglichen App-Images an, das gemischt werden soll. Dieses Flag ist nur für die IVMRMixerBitmap::UpdateAlphaBitmapParameters-Methode gültig. Für die IVMRMixerBitmap::SetAlphaBitmap-Methode muss das rSrc-Element auf die gesamte Bitmap verweisen.

hdc

Das Handle zum Gerätekontext für die Bitmap. Geben Sie NULL an, wenn sich die Bitmap auf einer DirectDraw-Oberfläche befindet.

pDDS

Zeiger auf eine DirectDraw-Oberfläche, die die Bitmap enthält. Geben Sie NULL an, wenn die Bitmap aus einem GDI-Gerätekontext abgerufen werden soll. Wenn eine DirectDraw-Oberfläche angegeben wird, muss das Pixelformat ARGB-32 oder RGB-32 sein. Wenn die Oberfläche alpha pro Pixel enthält, legen Sie nicht das VMRBITMAP_SRCCOLORKEY-Flag in dwFlags fest.

rSrc

Gibt das Quellrechteck im GDI-Gerätekontext oder auf der DirectDraw-Oberfläche an.

rDest

Gibt das Zielrechteck im Kompositionsbereich an.

fAlpha

Gibt den Alpha-Blending-Wert an. muss ein Wert zwischen 0,0 und 1,0 (einschließlich) sein.

clrSrcKey

Gibt den Quellfarbschlüssel an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

DirectShow-Strukturen

Freigeben über