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

Establece los identificadores de descriptor de CPU para los destinos de representación y la galería de símbolos de profundidad.

Sintaxis

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

Número de entradas de la matriz pRenderTargetDescriptors (oscila entre 0 y D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Si este parámetro es distinto de cero, el número de entradas de la matriz a la que apunta pRenderTargetDescriptors debe ser igual al número de este parámetro.

[in, optional] pRenderTargetDescriptors

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Especifica una matriz de estructuras de D3D12_CPU_DESCRIPTOR_HANDLE que describen los identificadores del descriptor de CPU que representan el inicio del montón de descriptores de destino de representación. Si este parámetro es NULL y NumRenderTargetDescriptors es 0, no se enlaza ningún destino de representación.

[in] RTsSingleHandleToDescriptorRange

Tipo: BOOL

True significa que el identificador pasado es el puntero a un intervalo contiguo de descriptores NumRenderTargetDescriptors . Este caso es útil si el conjunto de descriptores para enlazar ya tiene lugar contigua en la memoria (por lo que todo lo necesario es un identificador para el primero). Por ejemplo, si NumRenderTargetDescriptors es 3, el diseño de memoria se toma de la siguiente manera:

En este caso, el controlador desreferencia el controlador e incrementa la memoria a la que se apunta.

False significa que el identificador es el primero de una matriz de identificadores NumRenderTargetDescriptors . El caso falso permite a una aplicación enlazar un conjunto de descriptores desde diferentes ubicaciones a la vez. Una vez más, suponiendo que NumRenderTargetDescriptors es 3, el diseño de memoria se toma de la siguiente manera:

En este caso, el controlador desreferencia tres identificadores que se espera que sean adyacentes entre sí en la memoria.

[in, optional] pDepthStencilDescriptor

Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE*

Puntero a una estructura de D3D12_CPU_DESCRIPTOR_HANDLE que describe el identificador del descriptor de CPU que representa el inicio del montón que contiene el descriptor de galería de símbolos de profundidad. Si este parámetro es NULL, no se enlaza ningún descriptor de galería de símbolos de profundidad.

Valor devuelto

None

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3d12.lib
Archivo DLL	D3d12.dll

Consulte también

ID3D12GraphicsCommandList