METODE ID2D1Bitmap::CopyFromMemory (d2d1.h)

  • Artikel

Menyalin wilayah yang ditentukan dari memori ke bitmap saat ini.

Sintaks

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

Parameter

[in, optional] dstRect

Jenis: const D2D1_RECT_U*

Dalam bitmap saat ini, persegi panjang tempat wilayah yang ditentukan oleh srcRect disalin.

[in] srcData

Jenis: const void*

Data yang akan disalin.

pitch

Jenis: UINT32

Langkah, atau pitch, dari bitmap sumber yang disimpan di srcData. Langkahnya adalah jumlah byte dari pemindaian (satu baris piksel dalam memori). Langkah ini dapat dihitung dari rumus berikut: lebar piksel * byte per piksel + padding memori.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini tidak memperbarui ukuran bitmap saat ini. Jika isi bitmap sumber tidak pas di bitmap saat ini, metode ini gagal. Selain itu, perhatikan bahwa metode ini tidak melakukan konversi format; dua format bitmap harus cocok.

Jika metode ini melewati input yang tidak valid (seperti persegi tujuan yang tidak valid), dapat menghasilkan hasil yang tidak dapat diprediksi, seperti gambar yang terdistorsi atau kegagalan perangkat.

Memanggil metode ini dapat menyebabkan batch saat ini memerah jika bitmap aktif dalam batch. Jika batch yang dibersihkan tidak berhasil diselesaikan, metode ini gagal. Namun, metode ini tidak menghapus status kesalahan target render tempat batch dihapus. Status HRESULT dan tag yang gagal akan dikembalikan pada panggilan berikutnya ke EndDraw atau Flush.

Dimulai dengan Windows 8.1, metode ini mendukung bitmap terkompresi blok. Jika Anda menggunakan format terkompresi blok, koordinat akhir parameter srcRect harus kelipatan 4 atau metode mengembalikan E_INVALIDARG.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header d2d1.h
Pustaka D2d1.lib
DLL D2d1.dll

Lihat juga

ID2D1Bitmap