Bagikan melalui

Struktur VMRALPHABITMAP (strmif.h)

  • Artikel

[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