METODE ID3D12GraphicsCommandList::OMSetRenderTargets (d3d12.h)

Artikel
02/26/2024

Mengatur handel deskriptor CPU untuk target render dan stensil kedalaman.

Sintaks

void OMSetRenderTargets(
  [in]           UINT                              NumRenderTargetDescriptors,
  [in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pRenderTargetDescriptors,
  [in]           BOOL                              RTsSingleHandleToDescriptorRange,
  [in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pDepthStencilDescriptor
);

Parameter

[in] NumRenderTargetDescriptors

Jenis: UINT

Jumlah entri dalam array pRenderTargetDescriptors (rentang antara 0 dan D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Jika parameter ini bukan nol, jumlah entri dalam array tempat pRenderTargetDescriptors menunjuk harus sama dengan angka dalam parameter ini.

[in, optional] pRenderTargetDescriptors

Jenis: const D3D12_CPU_DESCRIPTOR_HANDLE*

Menentukan array struktur D3D12_CPU_DESCRIPTOR_HANDLE yang menjelaskan handel deskriptor CPU yang mewakili awal tumpuk deskriptor target render. Jika parameter ini adalah NULL dan NumRenderTargetDescriptors adalah 0, tidak ada target render yang terikat.

[in] RTsSingleHandleToDescriptorRange

Jenis: BOOL

Benar berarti handel yang diteruskan adalah penunjuk ke rentang deskriptor NumRenderTargetDescriptors yang berdekatan. Kasus ini berguna jika sekumpulan deskriptor untuk mengikat sudah berdekatan dalam memori (jadi yang diperlukan hanyalah handel untuk yang pertama). Misalnya, jika NumRenderTargetDescriptors adalah 3, maka tata letak memori diambil sebagai berikut:

Tata letak memori dengan parameter diatur ke true

Dalam hal ini driver mendereferensikan handel dan kemudian menaikkan memori yang ditunjukkan.

False berarti bahwa handel adalah yang pertama dari array handel NumRenderTargetDescriptors . Kasus palsu memungkinkan aplikasi untuk mengikat sekumpulan deskriptor dari lokasi yang berbeda sekaligus. Sekali lagi dengan asumsi bahwa NumRenderTargetDescriptors adalah 3, tata letak memori diambil sebagai berikut:

Tata letak memori dengan parameter diatur ke false

Dalam hal ini dereferensi driver tiga handel yang diharapkan berdekatan satu sama lain dalam memori.

[in, optional] pDepthStencilDescriptor

Jenis: const D3D12_CPU_DESCRIPTOR_HANDLE*

Penunjuk ke struktur D3D12_CPU_DESCRIPTOR_HANDLE yang menjelaskan handel deskriptor CPU yang mewakili awal timbunan yang menyimpan deskriptor stensil kedalaman. Jika parameter ini NULL, tidak ada deskriptor stensil kedalaman yang terikat.

Mengembalikan nilai

Tidak ada

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d12.h
Pustaka	D3d12.lib
DLL	D3d12.dll

Lihat juga

ID3D12GraphicsCommandList

Bagikan melalui