Compartilhar via


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:

Layout de memória com parâmetro definido como true 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:

Layout de memória com parâmetro definido como false 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