ID3D11Device::CreateRenderTargetView method (d3d11.h)

Membuat tampilan target render untuk mengakses data sumber daya.

Sintaks

HRESULT CreateRenderTargetView(
  [in]            ID3D11Resource                      *pResource,
  [in, optional]  const D3D11_RENDER_TARGET_VIEW_DESC *pDesc,
  [out, optional] ID3D11RenderTargetView              **ppRTView
);

Parameter

[in] pResource

Jenis: ID3D11Resource*

Pointer ke ID3D11Resource yang mewakili target render. Sumber daya ini harus dibuat dengan bendera D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Jenis: const D3D11_RENDER_TARGET_VIEW_DESC*

Penunjuk ke D3D11_RENDER_TARGET_VIEW_DESC yang mewakili deskripsi tampilan target render. Atur parameter ini ke NULL untuk membuat tampilan yang mengakses semua subsumber daya di tingkat mipmap 0.

[out, optional] ppRTView

Jenis: ID3D11RenderTargetView**

Alamat pointer ke ID3D11RenderTargetView. Atur parameter ini ke NULL untuk memvalidasi parameter input lainnya (metode akan mengembalikan S_FALSE jika parameter input lainnya lulus validasi).

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 11.

Keterangan

Tampilan target render dapat terikat ke tahap output-merger dengan memanggil ID3D11DeviceContext::OMSetRenderTargets.

Runtime Direct3D 11.1, yang tersedia dimulai dengan Windows 8, memungkinkan Anda menggunakan CreateRenderTargetView untuk tujuan baru berikut.

Anda dapat membuat tampilan sumber daya video target render sehingga shader Direct3D dapat memproses tampilan target render tersebut. Sumber daya video ini adalah Texture2D atau Texture2DArray. Nilai dalam anggota ViewDimension dari struktur D3D11_RENDER_TARGET_VIEW_DESC untuk tampilan target render yang dibuat harus cocok dengan jenis sumber daya video, D3D11_RTV_DIMENSION_TEXTURE2D untuk Texture2D dan D3D11_RTV_DIMENSION_TEXTURE2DARRAY untuk Texture2DArray. Selain itu, format sumber daya video yang mendasar membatasi format yang dapat digunakan tampilan. Nilai format sumber daya video pada halaman referensi DXGI_FORMAT menentukan nilai format yang dibatasi tampilannya.

Logika pencegahan konflik baca+tulis runtime (yang menghentikan sumber daya terikat sebagai SRV dan RTV atau UAV pada saat yang sama) memperlakukan tampilan berbagai bagian dari permukaan video yang sama sebagai konflik untuk kesederhanaan. Oleh karena itu, runtime tidak memungkinkan aplikasi untuk membaca dari luma sementara aplikasi secara bersamaan merender ke klorma di permukaan yang sama meskipun perangkat keras mungkin memungkinkan operasi simultan ini.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d11.h
Pustaka	D3D11.lib

Lihat juga

ID3D11Device