Struktur VMRALPHABITMAP (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Struktur VMRALPHABITMAP digunakan dalam metode IVMR-7 filter VMMRMixerBitmap ketika aplikasi menyediakan bitmap campuran alfa statis untuk ditampilkan pada bingkai video yang disusun.

Sintaks

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

Anggota

dwFlags

Bendera yang menginstruksikan mixer tempat menemukan bitmap. Nilai berikut didefinisikan.

Nilai	Makna
VMRBITMAP_DISABLE 0x00000001	Nonaktifkan bitmap. Bendera ini tidak dapat digabungkan dengan bendera lain.
VMRBITMAP_HDC 0x00000002	Dapatkan bitmap dari HDC. Jika bendera ini diatur, anggota hdc harus menentukan handel yang valid ke konteks perangkat, dan anggota pDDS harus NULL. Jika bendera ini tidak ada, anggota pDDS harus menunjuk ke permukaan DirectDraw yang valid, dan anggota hdc harus NULL.
VMRBITMAP_ENTIREDDS 0x00000004	Ambil seluruh permukaan DirectDraw. Ketika bendera ini ditentukan, rSrc diabaikan. Bendera ini tidak dapat digabungkan dengan bendera VMRBITMAP_HDC .
VMRBITMAP_SRCCOLORKEY 0x00000008	Nilai clrSrcKey valid dan harus digunakan saat memadukan.
VMRBITMAP_SRCRECT 0x00000010	Menunjukkan bahwa persegi panjang rSrc valid dan menentukan sub-persegi panjang gambar aplikasi asli yang akan dipadukan. Bendera ini hanya berlaku untuk metode IVMRMixerBitmap::UpdateAlphaBitmapParameters . Untuk metode IVMRMixerBitmap::SetAlphaBitmap , anggota rSrc harus merujuk ke seluruh bitmap.

hdc

Handel ke konteks perangkat untuk bitmap. Tentukan NULL jika bitmap terletak di permukaan DirectDraw.

pDDS

Penunjuk ke permukaan DirectDraw yang berisi bitmap. Tentukan NULL jika bitmap akan diperoleh dari konteks perangkat GDI. Jika permukaan DirectDraw ditentukan, format piksel harus ARGB-32 atau RGB-32. Jika permukaan berisi alfa per piksel, jangan atur bendera VMRBITMAP_SRCCOLORKEY di dwFlags.

rSrc

Menentukan persegi panjang sumber dalam konteks perangkat GDI atau permukaan DirectDraw.

rDest

Menentukan persegi panjang tujuan dalam ruang komposisi.

fAlpha

Menentukan nilai penpaduan alfa; harus berupa nilai dari 0,0 hingga 1,0 (inklusif).

clrSrcKey

Menentukan kunci warna sumber.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	strmif.h (termasuk Dshow.h)

Lihat juga

Struktur DirectShow