Метод ID3D12GraphicsCommandList::OMSetRenderTargets (d3d12.h)
Задает дескриптор ЦП для целевых объектов отрисовки и трафарета глубины.
Синтаксис
void OMSetRenderTargets(
[in] UINT NumRenderTargetDescriptors,
[in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pRenderTargetDescriptors,
[in] BOOL RTsSingleHandleToDescriptorRange,
[in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pDepthStencilDescriptor
);
Параметры
[in] NumRenderTargetDescriptors
Тип: UINT
Количество записей в массиве pRenderTargetDescriptors (в диапазоне от 0 до D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Если этот параметр не является нулевым, количество записей в массиве, на которые указывает pRenderTargetDescriptors, должно быть равно числу в этом параметре.
[in, optional] pRenderTargetDescriptors
Тип: const D3D12_CPU_DESCRIPTOR_HANDLE*
Задает массив D3D12_CPU_DESCRIPTOR_HANDLE структур, описывающих дескрипторы дескриптора ЦП, которые представляют начало кучи целевых дескрипторов отрисовки. Если этот параметр имеет значение NULL, а NumRenderTargetDescriptors имеет значение 0, целевые объекты отрисовки не привязаны.
[in] RTsSingleHandleToDescriptorRange
Тип: BOOL
Значение true означает, что передаваемый дескриптор является указателем на непрерывный диапазон дескрипторов NumRenderTargetDescriptors . Этот случай полезен, если набор дескрипторов для привязки уже является непрерывным в памяти (поэтому все, что нужно, — это дескриптор для первого). Например, если NumRenderTargetDescriptors равно 3, то макет памяти принимается следующим образом:
В этом случае драйвер разыменовывает дескриптор, а затем увеличивает объем памяти, на который указывает.
Значение False означает, что дескриптор является первым из массива дескрипторов NumRenderTargetDescriptors . Ложное значение позволяет приложению одновременно привязать набор дескрипторов из разных расположений. Опять же при условии, что NumRenderTargetDescriptors равно 3, макет памяти принимается следующим образом:
В этом случае драйвер разыменовывает три дескриптора, которые должны находиться рядом друг с другом в памяти.
[in, optional] pDepthStencilDescriptor
Тип: const D3D12_CPU_DESCRIPTOR_HANDLE*
Указатель на структуру D3D12_CPU_DESCRIPTOR_HANDLE , описывающую дескриптор дескриптора ЦП, представляющий начало кучи, содержащей дескриптор трафарета глубины. Если этот параметр имеет значение NULL, дескриптор трафарета глубины не привязывается.
Возвращаемое значение
None
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d3d12.h |
| Библиотека | D3d12.lib |
| DLL | D3d12.dll |