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 |