Metode IVMRMixerBitmap::SetAlphaBitmap (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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.]

Metode SetAlphaBitmap menentukan gambar bitmap baru dan lokasi sumber bitmap dan bagaimana dan di mana bitmap harus dirender pada persegi tujuan.

Sintaks

HRESULT SetAlphaBitmap(
  [in] const VMRALPHABITMAP *pBmpParms
);

Parameter

[in] pBmpParms

Penunjuk ke struktur VMRALPHABITMAP yang berisi informasi tentang bitmap.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan dikembalikan.

Menampilkan kode	Deskripsi
E_POINTER	pBmpParms adalah NULL.
E_INVALIDARG	Argumen tidak valid. Lihat Keterangan.
E_OUTOFMEMORY	Tidak dapat membuat DC tujuan atau DIBSection untuk bitmap.
E_FAIL	BitBlt ke permukaan bitmap gagal.

Keterangan

Untuk menghapus bitmap, atur struktur VMRALPHABITMAP dan panggil SetAlphaBitmap lagi.

Metode ini mungkin mengembalikan E_INVALIDARG karena beberapa alasan:

Nilai fAlpha tidak valid.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib