Método ID3D12GraphicsCommandList::OMSetRenderTargets (d3d12.h)

Define identificadores de descritor de CPU para os destinos de renderização e o estêncil de profundidade.

Sintaxe

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

Parâmetros

[in] NumRenderTargetDescriptors

Tipo: UINT

O número de entradas na matriz pRenderTargetDescriptors (intervalos entre 0 e D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Se esse parâmetro for diferente de zero, o número de entradas na matriz para a qual os pontos pRenderTargetDescriptors deverão ser iguais ao número nesse parâmetro.

[in, optional] pRenderTargetDescriptors

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Especifica uma matriz de estruturas D3D12_CPU_DESCRIPTOR_HANDLE que descrevem os identificadores do descritor de CPU que representa o início do heap de descritores de destino de renderização. Se esse parâmetro for NULL e NumRenderTargetDescriptors for 0, nenhum destino de renderização será associado.

[in] RTsSingleHandleToDescriptorRange

Tipo: BOOL

True significa que o identificador passado é o ponteiro para um intervalo contíguo de descritores NumRenderTargetDescriptors . Esse caso será útil se o conjunto de descritores a serem associados já for contíguo na memória (portanto, tudo o que é necessário é um identificador para o primeiro). Por exemplo, se NumRenderTargetDescriptors for 3, o layout de memória será obtido da seguinte maneira:

Nesse caso, o driver desreferencia o identificador e incrementa a memória que está sendo apontada.

False significa que o identificador é o primeiro de uma matriz de identificadores NumRenderTargetDescriptors . O caso false permite que um aplicativo associe um conjunto de descritores de locais diferentes ao mesmo tempo. Novamente supondo que NumRenderTargetDescriptors seja 3, o layout de memória é obtido da seguinte maneira:

Nesse caso, o driver desreferencia três identificadores que devem ser adjacentes entre si na memória.

[in, optional] pDepthStencilDescriptor

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Um ponteiro para uma estrutura D3D12_CPU_DESCRIPTOR_HANDLE que descreve o identificador do descritor de CPU que representa o início do heap que contém o descritor de estêncil de profundidade. Se esse parâmetro for NULL, nenhum descritor de estêncil de profundidade será associado.

Retornar valor

Nenhum

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d12.h
Biblioteca	D3d12.lib
DLL	D3d12.dll

Confira também

ID3D12GraphicsCommandList