Struttura VMRALPHABITMAP (strmif.h)

Articolo
03/13/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La struttura VMRALPHABITMAP viene usata nei metodi IVMRMixerBitmap del filtro VMR-7 quando l'applicazione fornisce una bitmap alfa-blend statica da visualizzare nel frame video composito.

Sintassi

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

Members

dwFlags

Contrassegni che indicano al mixer dove trovare la bitmap. I valori seguenti sono definiti.

Valore	Significato
VMRBITMAP_DISABLE 0x00000001	Disabilitare la bitmap. Questo flag non può essere combinato con altri flag.
VMRBITMAP_HDC 0x00000002	Ottenere la bitmap dall'HDC. Se questo flag è impostato, il membro hdc deve specificare un handle valido in un contesto del dispositivo e il membro pDDS deve essere NULL. Se questo flag è assente, il membro pDDS deve puntare a una superficie DirectDraw valida e il membro hdc deve essere NULL.
VMRBITMAP_ENTIREDDS 0x00000004	Prendere l'intera superficie DirectDraw. Quando viene specificato questo flag, rSrc viene ignorato. Questo flag non può essere combinato con il flag VMRBITMAP_HDC .
VMRBITMAP_SRCCOLORKEY 0x00000008	Il valore clrSrcKey è valido e deve essere usato durante la fusione.
VMRBITMAP_SRCRECT 0x00000010	Indica che il rettangolo rSrc è valido e specifica un sotto rettangolo dell'immagine dell'app originale da unire. Questo flag è valido solo per il metodo IVMRMixerBitmap::UpdateAlphaBitmapParameters . Per il metodo IVMRMixerBitmap::SetAlphaBitmap , il membro rSrc deve fare riferimento all'intera bitmap.

hdc

Handle nel contesto del dispositivo per la bitmap. Specificare NULL se la bitmap si trova in un'area DirectDraw.

pDDS

Puntatore a una superficie DirectDraw che contiene la bitmap. Specificare NULL se la bitmap deve essere ottenuta da un contesto di dispositivo GDI. Se viene specificata una superficie DirectDraw, il formato pixel deve essere ARGB-32 o RGB-32. Se la superficie contiene alfa per pixel, non impostare il flag di VMRBITMAP_SRCCOLORKEY in dwFlags.

rSrc

Specifica il rettangolo di origine nel contesto del dispositivo GDI o nell'area DirectDraw.

rDest

Specifica il rettangolo di destinazione nello spazio di composizione.

fAlpha

Specifica il valore di fusione alfa; deve essere un valore compreso tra 0,0 e 1,0 (incluso).

clrSrcKey

Specifica la chiave di colore di origine.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Strutture DirectShow

Share via