ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,ID2D1BitmapRenderTarget**) metode (d2d1.h)

Membuat target render bitmap untuk digunakan selama gambar di luar layar menengah yang kompatibel dengan target render saat ini.

Sintaks

HRESULT CreateCompatibleRenderTarget(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

Parameter

desiredSize

Jenis: [in] const D2D1_SIZE_F*

Ukuran target render baru yang diinginkan (dalam piksel independen perangkat), jika harus berbeda dari target render asli. Untuk informasi selengkapnya, lihat bagian Keterangan.

desiredPixelSize

Jenis: [in] const D2D1_SIZE_U*

Ukuran target render baru yang diinginkan dalam piksel jika harus berbeda dari target render asli. Untuk informasi lebih lanjut, lihat bagian Keterangan.

desiredFormat

Jenis: [in] const D2D1_PIXEL_FORMAT*

Format piksel dan mode alfa yang diinginkan dari target render baru. Jika format piksel diatur ke DXGI_FORMAT_UNKNOWN, target render baru menggunakan format piksel yang sama dengan target render asli. Jika mode alfa D2D1_ALPHA_MODE_UNKNOWN, mode alfa dari target render baru default ke D2D1_ALPHA_MODE_PREMULTIPLIED. Untuk informasi tentang format piksel yang didukung, lihat Format Piksel dan Mode Alfa yang Didukung.

options

Jenis: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

Nilai yang menentukan apakah target render baru harus kompatibel dengan GDI.

bitmapRenderTarget

Jenis: [out] ID2D1BitmapRenderTarget**

Ketika metode ini kembali, berisi penunjuk ke penunjuk ke target render bitmap baru. Parameter ini diteruskan tanpa diinisialisasi.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ukuran piksel dan DPI target render baru dapat diubah dengan menentukan nilai untuk desiredSize atau desiredPixelSize:

• Jika desiredSize ditentukan tetapi desiredPixelSize tidak, ukuran piksel dihitung dari ukuran yang diinginkan menggunakan DPI target induk. Jika peta DesiredSize ke ukuran piksel bilangan bulat, DPI target render yang kompatibel sama dengan DPI target induk. Jika desiredSize memetakan ke ukuran fraksional-piksel, ukuran piksel dibulatkan ke bilangan bulat terdekat dan DPI untuk target render yang kompatibel sedikit lebih tinggi daripada DPI target render induk. Dalam semua kasus, peta koordinat (desiredSize.width, desiredSize.height) ke sudut kanan bawah target render yang kompatibel.
• Jika desiredPixelSize ditentukan dan desiredSize tidak, DPI dari target render baru sama dengan target render asli.
• Jika desiredSize dan desiredPixelSize ditentukan, DPI target render baru dihitung untuk memperhitungkan perbedaan skala.
• Jika desiredSize atau desiredPixelSize tidak ditentukan, ukuran target render baru dan DPI cocok dengan target render asli.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d2d1.h
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1RenderTarget