METODE ID2D1Bitmap::CopyFromMemory (d2d1.h)
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk