Метод ID3D11Device::CreateRenderTargetView (d3d11.h)

  • Статья

Создает представление целевого объекта отрисовки для доступа к данным ресурсов.

Синтаксис

HRESULT CreateRenderTargetView(
  [in]            ID3D11Resource                      *pResource,
  [in, optional]  const D3D11_RENDER_TARGET_VIEW_DESC *pDesc,
  [out, optional] ID3D11RenderTargetView              **ppRTView
);

Параметры

[in] pResource

Тип: ID3D11Resource*

Указатель на ID3D11Resource , представляющий целевой объект отрисовки. Этот ресурс должен быть создан с флагом D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Тип: const D3D11_RENDER_TARGET_VIEW_DESC*

Указатель на D3D11_RENDER_TARGET_VIEW_DESC , представляющий описание представления целевого объекта отрисовки. Присвойте этому параметру значение NULL , чтобы создать представление, которое обращается ко всем подресурсам на уровне MIP-карты 0.

[out, optional] ppRTView

Тип: ID3D11RenderTargetView**

Адрес указателя на ID3D11RenderTargetView. Присвойте этому параметру значение NULL , чтобы проверить другие входные параметры (метод вернет S_FALSE, если другие входные параметры пройдут проверку).

Возвращаемое значение

Тип: HRESULT

Этот метод возвращает один из кодов возврата Direct3D 11.

Комментарии

Представление цели отрисовки можно привязать к этапу слияния выходных данных, вызвав ID3D11DeviceContext::OMSetRenderTargets.

Среда выполнения Direct3D 11.1, доступная начиная с Windows 8, позволяет использовать CreateRenderTargetView для следующих новых целей.

Вы можете создавать целевые представления видеоресурса, чтобы шейдеры Direct3D могли обрабатывать эти представления, предназначенные для отрисовки. Это либо Texture2D , либо Texture2DArray. Значение в элементе ViewDimension структуры D3D11_RENDER_TARGET_VIEW_DESC для созданного целевого представления отрисовки должно соответствовать типу видеоресурса, D3D11_RTV_DIMENSION_TEXTURE2D для Texture2D и D3D11_RTV_DIMENSION_TEXTURE2DARRAY для Texture2DArray. Кроме того, формат базового видеоресурса ограничивает форматы, которые может использовать представление. Значения формата видеоресурсов на странице ссылки на DXGI_FORMAT указывают значения формата, которыми ограничены представления.

Логика предотвращения конфликтов чтения и записи среды выполнения (которая предотвращает привязку ресурса как SRV и RTV или UAV одновременно) рассматривает представления различных частей одной и той же области видео как конфликтующие для простоты. Таким образом, среда выполнения не позволяет приложению считывать данные из luma, в то время как приложение одновременно выполняет отрисовку в chroma на одной поверхности, даже если оборудование может разрешить эти одновременные операции.

Требования

Требование Значение
Целевая платформа Windows
Header d3d11.h
Библиотека D3D11.lib

См. также раздел

ID3D11Device