Share via

ID2D1Factory::CreateDxgiSurfaceRenderTarget(IDXGISurface*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) metode (d2d1.h)

  • Artikel

Membuat target render yang menarik ke permukaan DirectX Graphics Infrastructure (DXGI).

Sintaks

HRESULT CreateDxgiSurfaceRenderTarget(
  [in]  IDXGISurface                          *dxgiSurface,
  [ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
  [out] ID2D1RenderTarget                     **renderTarget
);

Parameter

[in] dxgiSurface

Jenis: IDXGISurface*

IDXGISurface tempat target render akan menarik.

[ref] 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

Untuk menulis ke permukaan Direct3D, Anda mendapatkan IDXGISurface dan meneruskannya ke metode CreateDxgiSurfaceRenderTarget untuk membuat target render permukaan DXGI; Anda kemudian dapat menggunakan target render permukaan DXGI untuk menggambar konten 2-D ke permukaan DXGI.

Target render permukaan DXGI adalah jenis ID2D1RenderTarget. Seperti target render Direct2D lainnya, Anda dapat menggunakannya untuk membuat sumber daya dan mengeluarkan perintah gambar.

Target render permukaan DXGI dan permukaan DXGI harus menggunakan format DXGI yang sama. Jika Anda menentukan format DXGI_FORMAT_UNKOWN saat Anda membuat target render, itu akan secara otomatis menggunakan format permukaan.

Target render permukaan DXGI tidak melakukan sinkronisasi permukaan DXGI.

Untuk informasi selengkapnya tentang membuat dan menggunakan target render permukaan DXGI, lihat Gambaran Umum Interoperabilitas Direct2D dan Direct3D.

Untuk bekerja dengan Direct2D, perangkat Direct3D yang menyediakan IDXGISurface harus dibuat dengan bendera D3D10_CREATE_DEVICE_BGRA_SUPPORT .

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 metode EndDraw target render mengembalikan kesalahan D2DERR_RECREATE_TARGET . Ketika Anda menerima kesalahan ini, Anda perlu membuat ulang target render (dan sumber daya apa pun yang dibuatnya).

Contoh

Lihat contoh kode di ID2D1Factory::CreateDxgiSurfaceRenderTarget.

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

CreateDxgiSurfaceRenderTarget(IDXGISurface,const D2D1_RENDER_TARGET_PROPERTIES,ID2D1RenderTarget)

Gambaran Umum Interoperabilitas Direct2D dan Direct3D

ID2D1Factory