Метод 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 |