Metodo ID3D12GraphicsCommandList::OMSetRenderTargets (d3d12.h)

Articolo
02/29/2024

Imposta gli handle del descrittore CPU per le destinazioni di rendering e lo stencil di profondità.

Sintassi

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

Parametri

[in] NumRenderTargetDescriptors

Tipo: UINT

Numero di voci nella matrice pRenderTargetDescriptors (intervalli compresi tra 0 e D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Se questo parametro è diverso da zero, il numero di voci nella matrice a cui pRenderTargetDescriptors deve corrispondere al numero in questo parametro.

[in, optional] pRenderTargetDescriptors

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Specifica una matrice di strutture D3D12_CPU_DESCRIPTOR_HANDLE che descrivono gli handle del descrittore della CPU che rappresenta l'inizio dell'heap dei descrittori di destinazione di rendering. Se questo parametro è NULL e NumRenderTargetDescriptors è 0, non vengono associate destinazioni di rendering.

[in] RTsSingleHandleToDescriptorRange

Tipo: BOOL

True indica che l'handle passato è il puntatore a un intervallo contiguo di descrittori NumRenderTargetDescriptors . Questo caso è utile se il set di descrittori da associare è già contiguo in memoria (quindi tutto ciò che è necessario è un handle per il primo). Ad esempio, se NumRenderTargetDescriptors è 3, il layout della memoria viene preso come segue:

Layout di memoria con parametro impostato su true

In questo caso il driver dereferenzia l'handle e quindi incrementa la memoria a cui punta.

False significa che l'handle è il primo di una matrice di handle NumRenderTargetDescriptors . Il caso false consente a un'applicazione di associare un set di descrittori da posizioni diverse contemporaneamente. Supponendo di nuovo che NumRenderTargetDescriptors sia 3, il layout della memoria viene preso come segue:

Layout di memoria con parametro impostato su false

In questo caso, il driver dereferenzia tre handle che devono essere adiacenti tra loro in memoria.

[in, optional] pDepthStencilDescriptor

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Puntatore a una struttura D3D12_CPU_DESCRIPTOR_HANDLE che descrive l'handle descrittore della CPU che rappresenta l'inizio dell'heap che contiene il descrittore di profondità stencil. Se questo parametro è NULL, non è associato alcun descrittore di stencil di profondità.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3d12.lib
DLL	D3d12.dll

Vedi anche

ID3D12GraphicsCommandList

Condividi tramite