ID3D12GraphicsCommandList：：OMSetRenderTargets 方法 (d3d12.h)

项目
02/27/2024

设置呈现目标和深度模具的 CPU 描述符句柄。

语法

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

参数

[in] NumRenderTargetDescriptors

类型： UINT

pRenderTargetDescriptors 数组中的条目数 (范围为 0 到 D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT) 。如果此参数不为零，则 pRenderTargetDescriptors 指向的数组中的条目数必须等于此参数中的数目。

[in, optional] pRenderTargetDescriptors

类型： const D3D12_CPU_DESCRIPTOR_HANDLE*

指定 D3D12_CPU_DESCRIPTOR_HANDLE 结构的数组，这些结构描述 CPU 描述符句柄表示呈现器目标描述符堆的开头。如果此参数为 NULL 且 NumRenderTargetDescriptors 为 0，则不绑定呈现器目标。

[in] RTsSingleHandleToDescriptorRange

类型： BOOL

True 表示传入的句柄是指向 NumRenderTargetDescriptors 描述符 连续范围的指针。如果要绑定的描述符集恰好在内存 (中是连续的，因此只需要) 第一个描述符的句柄，则这种情况非常有用。例如，如果 NumRenderTargetDescriptors 为 3，则内存布局如下所示：