Metode IWICBitmapSource::CopyPixels (wincodec.h)

Menginstruksikan objek untuk menghasilkan piksel.

Sintaks

HRESULT CopyPixels(
  [in]  const WICRect *prc,
  [in]  UINT          cbStride,
  [in]  UINT          cbBufferSize,
  [out] BYTE          *pbBuffer
);

Parameter

[in] prc

Jenis: const WICRect*

Persegi panjang untuk disalin. Nilai NULL menentukan seluruh bitmap.

[in] cbStride

Jenis: UINT

Langkah bitmap

[in] cbBufferSize

Jenis: UINT

Ukuran buffer.

[out] pbBuffer

Jenis: BYTE*

Penunjuk ke buffer.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

CopyPixels adalah salah satu dari dua rutinitas pemrosesan gambar utama (yang lainnya adalah Lock) yang memicu pemrosesan aktual. Ini menginstruksikan objek untuk menghasilkan piksel sesuai dengan algoritmanya - ini mungkin melibatkan pendekodean sebagian JPEG yang disimpan di disk, menyalin blok memori, atau bahkan menghitung gradien yang kompleks secara analitis. Algoritma sepenuhnya tergantung pada objek yang mengimplementasikan antarmuka.

Pemanggil dapat membatasi operasi ke persegi panjang minat (ROI) menggunakan parameter rangkaian. Sub-persegi ROI harus sepenuhnya terkandung dalam batas bitmap. Menentukan NULL ROI menyiratkan bahwa seluruh bitmap harus dikembalikan.

Pemanggil mengontrol manajemen memori dan harus menyediakan buffer output (pbBuffer) untuk hasil salinan bersama dengan batas buffer (cbBufferSize). Parameter cbStride menentukan jumlah byte antara dua piksel yang berdekatan secara vertikal dalam buffer output. Pemanggil harus memastikan bahwa ada buffer yang memadai untuk menyelesaikan panggilan berdasarkan lebar, tinggi, dan format piksel bitmap dan sub-persegi panjang yang disediakan untuk metode salin.

Jika penelepon perlu melakukan banyak salinan IWICBitmapSource yang mahal seperti JPEG, disarankan untuk membuat IWICBitmap dalam memori terlebih dahulu.

Komentar Pengembang Codec

Penerima panggilan hanya boleh menulis ke yang pertama (prc-Width*bitsperpixel+7)/8 byte dari setiap baris buffer output (dalam hal ini, baris adalah string byte cbStride berturut-turut>).

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