Fungsi MFCopyImage (mfapi.h)

Menyalin gambar atau bidang gambar dari satu buffer ke buffer lainnya.

Sintaks

HRESULT MFCopyImage(
  [in] BYTE       *pDest,
  [in] LONG       lDestStride,
  [in] const BYTE *pSrc,
  [in] LONG       lSrcStride,
  [in] DWORD      dwWidthInBytes,
  [in] DWORD      dwLines
);

Parameter

[in] pDest

Arahkan ke awal baris pertama piksel di buffer tujuan.

[in] lDestStride

Langkah buffer tujuan, dalam byte.

[in] pSrc

Arahkan ke awal baris pertama piksel dalam gambar sumber.

[in] lSrcStride

Langkah gambar sumber, dalam byte.

[in] dwWidthInBytes

Lebar gambar, dalam byte.

[in] dwLines

Jumlah baris piksel yang akan disalin.

Nilai kembali

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

Keterangan

Fungsi ini menyalin satu bidang gambar. Untuk format YUV planar, Anda harus memanggil fungsi sekali untuk setiap bidang. Dalam hal ini, pDest dan pSrc harus menunjuk ke awal setiap bidang.

Fungsi ini dioptimalkan jika set instruksi MMX, SSE, atau SSE2 tersedia pada prosesor. Fungsi ini melakukan penyimpanan non-temporal (data ditulis ke memori secara langsung tanpa mencemari cache).

Catatan Sebelum Windows 7, fungsi ini diekspor dari evr.dll. Mulai dari Windows 7, fungsi ini diekspor dari mfplat.dll, dan evr.dll mengekspor fungsi stub yang memanggil ke mfplat.dll. Untuk informasi selengkapnya, lihat Perubahan Pustaka di Windows 7.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	mfapi.h
Pustaka	Evr.lib
DLL	Mfplat.dll

Lihat juga

Stride Gambar

Fungsi Media Foundation

Jenis Media