ID2D1Factory::CreateDxgiSurfaceRenderTarget(IDXGISurface*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) metode (d2d1.h)
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)