Metode IWICBitmapFrameEncode::WriteSource (wincodec.h)

Mengodekan sumber bitmap.

Sintaks

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

Parameter

[in] pIBitmapSource

Jenis: IWICBitmapSource*

Sumber bitmap yang akan dikodekan.

[in] prc

Jenis: WICRect*

Persegi panjang ukuran sumber bitmap.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika SetSize tidak dipanggil sebelum memanggil WriteSource, ukuran yang diberikan dalam rangkaian digunakan jika bukan NULL. Jika tidak, ukuran IWICBitmapSource yang diberikan dalam pIBitmapSource digunakan.

Jika SetPixelFormat tidak dipanggil sebelum memanggil WriteSource, format piksel IWICBitmapSource yang diberikan dalam pIBitmapSource digunakan.

Jika SetResolution tidak dipanggil sebelum memanggil WriteSource, format piksel pIBitmapSource digunakan.

Jika SetPalette tidak dipanggil sebelum memanggil WriteSource, format piksel target diindeks, dan format piksel pIBitmapSource cocok dengan format piksel bingkai encoder, maka format piksel pIBitmapSource digunakan.

Saat mengodekan gambar GIF, jika palet global diatur dan palet tingkat bingkai tidak diatur langsung oleh pengguna atau oleh codec GIF vendor perangkat lunak independen (ISV) kustom, WriteSource akan menggunakan palet global untuk mengodekan bingkai bahkan ketika pIBitmapSource memiliki palet tingkat bingkai.

Dimulai dengan Windows Vista, panggilan WriteSource berulang dapat dilakukan selama total akumulasi tinggi rect sumber sama dengan yang diatur melalui SetSize.

Dimulai dengan Windows 8.1, rect sumber harus setidaknya dimensi yang diatur melalui SetSize. Jika lebar rect sumber melebihi lebar SetSize , piksel tambahan di sisi kanan diabaikan. Jika tinggi rect sumber melebihi tinggi yang belum terisi yang tersisa, baris pemindaian tambahan di bagian bawah diabaikan.

Persyaratan

Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll

Lihat juga

Konseptual

Cara Menulis codec WIC-Enabled

IWICBitmapFrameEncode

Gambaran Umum Komponen Pencitraan Windows