Share via

ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**) metode (d2d1.h)

  • Artikel

Membuat target render yang dirender ke bitmap Microsoft Windows Imaging Component (WIC).

Sintaks

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                          *target,
  [in]  const D2D1_RENDER_TARGET_PROPERTIES *renderTargetProperties,
  [out] ID2D1RenderTarget                   **renderTarget
);

Parameter

[in] target

Jenis: IWICBitmap*

Bitmap yang menerima output penyajian dari target render.

[in] renderTargetProperties

Jenis: const D2D1_RENDER_TARGET_PROPERTIES*

Mode penyajian, format piksel, opsi jarak jauh, informasi DPI, dan dukungan DirectX minimum yang diperlukan untuk penyajian perangkat keras. Untuk informasi tentang format piksel yang didukung, lihat Format Piksel yang Didukung dan Mode Alfa.

[out] renderTarget

Jenis: ID2D1RenderTarget**

Ketika metode ini kembali, berisi alamat penunjuk ke objek ID2D1RenderTarget yang dibuat oleh metode ini.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Anda harus menggunakan D2D1_FEATURE_LEVEL_DEFAULT untuk anggota minLevel dari parameter renderTargetProperties dengan metode ini.

Aplikasi Anda harus membuat target render sekali dan menahannya selama masa pakai aplikasi atau sampai kesalahan D2DERR_RECREATE_TARGET diterima. Ketika Anda menerima kesalahan ini, Anda perlu membuat ulang target render (dan sumber daya apa pun yang dibuatnya).

Catatan

Metode ini tidak didukung pada Windows Phone dan akan gagal ketika dipanggil pada perangkat dengan kode kesalahan 0x8899000b ("Tidak ada perangkat penyajian perangkat keras yang tersedia untuk operasi ini"). Karena Windows Phone Emulator mendukung penyajian WARP, metode ini akan gagal ketika dipanggil pada emulator dengan kode kesalahan yang berbeda, 0x88982f80 (wincodec_err_unsupportedpixelformat).

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

ID2D1Factory