VMRALPHABITMAP-Struktur (strmif.h)
[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 |
|---|---|
|
Deaktivieren Sie die Bitmap. Dieses Flag kann nicht mit anderen Flags kombiniert werden. |
|
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. |
|
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. |
|
Der clrSrcKey-Wert ist gültig und sollte beim Mischen verwendet werden. |
|
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) |