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 |