ID3D12GraphicsCommandList：：OMSetRenderTargets 方法 (d3d12.h)

發行項
02/26/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*

指定描述 CPU 描述項句柄的D3D12_CPU_DESCRIPTOR_HANDLE 結構陣列，此句柄代表轉譯目標描述項堆積的開頭。如果此參數為 NULL 且 NumRenderTargetDescriptors 為 0，則不會繫結轉譯目標。

[in] RTsSingleHandleToDescriptorRange

類型： BOOL

True 表示傳入的句柄是 連續範圍 NumRenderTargetDescriptors 描述元的指標。如果要系結的描述元集已經連續在記憶體 (，因此只需要第一個描述項的句柄) ，這個案例就很有用。例如，如果 NumRenderTargetDescriptors 為 3，則會採用記憶體配置，如下所示：