ID2D1Factory::CreateHwndRenderTarget(constD2D1_RENDER_TARGET_PROPERTIES*,constD2D1_HWND_RENDER_TARGET_PROPERTIES*,ID2D1HwndRenderTarget**) metode (d2d1.h)

Membuat ID2D1HwndRenderTarget, target render yang dirender ke jendela.

Saat Anda membuat target render, dan akselerasi perangkat keras tersedia, Anda mengalokasikan sumber daya pada GPU komputer. Dengan membuat target render sekali dan mempertahankannya selama mungkin, Anda mendapatkan manfaat performa. 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).

Sintaks

HRESULT CreateHwndRenderTarget(
  const D2D1_RENDER_TARGET_PROPERTIES      *renderTargetProperties,
  const D2D1_HWND_RENDER_TARGET_PROPERTIES *hwndRenderTargetProperties,
  ID2D1HwndRenderTarget                    **hwndRenderTarget
);

Parameter

renderTargetProperties

Jenis: [in] const D2D1_RENDER_TARGET_PROPERTIES*

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

hwndRenderTargetProperties

Jenis: [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES*

Handel jendela, ukuran awal (dalam piksel), dan opsi sajikan.

hwndRenderTarget

Jenis: [out] ID2D1HwndRenderTarget**

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

Nilai kembali

Jenis: HRESULT

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

Keterangan

Saat Anda membuat target render dan akselerasi perangkat keras tersedia, Anda mengalokasikan sumber daya di GPU komputer. Dengan membuat target render sekali dan mempertahankannya selama mungkin, Anda mendapatkan manfaat performa. 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).

Contoh

Contoh berikut membuat ID2D1HwndRenderTarget.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

Persyaratan

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

Lihat juga

ID2D1Factory