OMSetRenderTargets

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

Sintaxe

void OMSetRenderTargets(
    UINT NumRenderTargetDescriptors,
    const D3D12_CPU_DESCRIPTOR_HANDLE  pRenderTargetDescriptors,
    BOOL RTsSingleHandleToDescriptorRange,
    const D3D12_CPU_DESCRIPTOR_HANDLE  pDepthStencilDescriptor
)

Parâmetros

NumRenderTargetDescriptors [in]
Tipo: UINT O número de entradas na matriz pRenderTargetDescriptors (varia 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 pRenderTargetDescriptors aponta deverá ser igual ao número nesse parâmetro. pRenderTargetDescriptors [in, optional]
Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE * Especifica uma matriz de estruturas D3D12_CPU_DESCRIPTOR_HANDLE que descrevem os identificadores de descritor de CPU que representam 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. RTsSingleHandleToDescriptorRange [in]
Tipo: BOOL True significa que o identificador passado é o ponteiro para um intervalo contíguo de NumRenderTargetDescriptors descritores. Esse caso é útil se o conjunto de descritores a ser associado já estiver contíguo na memória (de modo que basta um identificador para o primeiro). Por exemplo, se NumRenderTargetDescriptors for 3, o layout de memória será interpretado da seguinte maneira:

Layout de memória com o parâmetro definido como true

Nesse caso, o driver desreferencia o identificador e, em seguida, incrementa a memória apontada. False significa que o identificador é o primeiro de uma matriz de NumRenderTargetDescriptors identificadores. O caso false permite que um aplicativo associe de uma só vez um conjunto de descritores de locais diferentes. Novamente supondo que NumRenderTargetDescriptors seja 3, o layout de memória será interpretado da seguinte maneira:

Layout de memória com o parâmetro definido como false

Nesse caso, o driver desreferencia três identificadores que devem estar adjacentes entre si na memória. pDepthStencilDescriptor [in, optional]
Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE * Um ponteiro para uma estrutura D3D12_CPU_DESCRIPTOR_HANDLE que descreve o identificador de 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.

Valor retornado

Tipo: void Nenhum.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12GraphicsCommandList

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Sintaxe

Parâmetros

Valor retornado

Requisitos

Confira também

​Sintaxe

​Parâmetros

​Valor retornado

​Requisitos

​Confira também

Sintaxe

Parâmetros

Valor retornado

Requisitos

Confira também