Método ID3D11Device::CreateRenderTargetView (d3d11.h)

Cria uma exibição de destino de renderização para acessar dados de recursos.

Sintaxe

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

Parâmetros

[in] pResource

Tipo: ID3D11Resource*

Ponteiro para um ID3D11Resource que representa um destino de renderização. Esse recurso deve ter sido criado com o sinalizador D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Tipo: const D3D11_RENDER_TARGET_VIEW_DESC*

Ponteiro para um D3D11_RENDER_TARGET_VIEW_DESC que representa uma descrição de exibição de destino de renderização. Defina esse parâmetro como NULL para criar uma exibição que acesse todos os sub-recursos no nível 0 do mipmap.

[out, optional] ppRTView

Tipo: ID3D11RenderTargetView**

Endereço de um ponteiro para um ID3D11RenderTargetView. Defina esse parâmetro como NULL para validar os outros parâmetros de entrada (o método retornará S_FALSE se os outros parâmetros de entrada passarem pela validação).

Retornar valor

Tipo: HRESULT

Esse método retorna um dos códigos de retorno do Direct3D 11.

Comentários

Uma exibição de destino de renderização pode ser associada ao estágio de fusão de saída chamando ID3D11DeviceContext::OMSetRenderTargets.

O runtime do Direct3D 11.1, que está disponível a partir do Windows 8, permite que você use CreateRenderTargetView para a nova finalidade a seguir.

Você pode criar exibições de destino de renderização de recursos de vídeo para que os sombreadores do Direct3D possam processar essas exibições de destino de renderização. Esses recursos de vídeo são Texture2D ou Texture2DArray. O valor no membro ViewDimension da estrutura D3D11_RENDER_TARGET_VIEW_DESC para uma exibição de destino de renderização criada deve corresponder ao tipo de recurso de vídeo, D3D11_RTV_DIMENSION_TEXTURE2D para Texture2D e D3D11_RTV_DIMENSION_TEXTURE2DARRAY para Texture2DArray. Além disso, o formato do recurso de vídeo subjacente restringe os formatos que a exibição pode usar. Os valores de formato de recurso de vídeo na página de referência DXGI_FORMAT especificam os valores de formato aos quais as exibições são restritas.

A lógica de prevenção de conflitos de leitura/gravação de runtime (que impede que um recurso seja associado como SRV e RTV ou UAV ao mesmo tempo) trata exibições de diferentes partes da mesma superfície de vídeo como conflitantes para simplificar. Portanto, o runtime não permite que um aplicativo leia do luma enquanto o aplicativo renderiza simultaneamente para chroma na mesma superfície, embora o hardware possa permitir essas operações simultâneas.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d11.h
Biblioteca	D3D11.lib

Confira também

ID3D11Device