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

Crea una vista de destino de representación para acceder a los datos de recursos.

Sintaxis

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

Parámetros

[in] pResource

Tipo: ID3D11Resource*

Puntero a un objeto ID3D11Resource que representa un destino de representación. Este recurso debe haberse creado con la marca D3D11_BIND_RENDER_TARGET .

[in, optional] pDesc

Tipo: const D3D11_RENDER_TARGET_VIEW_DESC*

Puntero a una D3D11_RENDER_TARGET_VIEW_DESC que representa una descripción de vista de destino de representación. Establezca este parámetro en NULL para crear una vista que tenga acceso a todos los subrecursos en el nivel de mapa mip 0.

[out, optional] ppRTView

Tipo: ID3D11RenderTargetView**

Dirección de un puntero a un id3D11RenderTargetView. Establezca este parámetro en NULL para validar los demás parámetros de entrada (el método devolverá S_FALSE si los demás parámetros de entrada pasan la validación).

Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los códigos de retorno de Direct3D 11.

Comentarios

Una vista de destino de representación se puede enlazar a la fase de fusión de salida llamando a ID3D11DeviceContext::OMSetRenderTargets.

El entorno de ejecución de Direct3D 11.1, que está disponible a partir de Windows 8, le permite usar CreateRenderTargetView para el siguiente propósito nuevo.

Puede crear vistas de destino de representación de recursos de vídeo para que los sombreadores de Direct3D puedan procesar esas vistas de destino de representación. Estos recursos de vídeo son Texture2D o Texture2DArray. El valor del miembro ViewDimension de la estructura D3D11_RENDER_TARGET_VIEW_DESC para una vista de destino de representación creada debe coincidir con el tipo de recurso de vídeo, D3D11_RTV_DIMENSION_TEXTURE2D para Texture2D y D3D11_RTV_DIMENSION_TEXTURE2DARRAY para Texture2DArray. Además, el formato del recurso de vídeo subyacente restringe los formatos que la vista puede usar. Los valores de formato de recursos de vídeo de la página de referencia de DXGI_FORMAT especifican los valores de formato a los que están restringidas las vistas.

La lógica de prevención de conflictos de lectura y escritura en tiempo de ejecución (que impide que un recurso esté enlazado como SRV y RTV o UAV al mismo tiempo) trata las vistas de diferentes partes de la misma superficie de vídeo que entran en conflicto por motivos de simplicidad. Por lo tanto, el tiempo de ejecución no permite que una aplicación lea de luma mientras la aplicación se representa simultáneamente en cromática en la misma superficie, aunque el hardware pueda permitir estas operaciones simultáneas.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d11.h
Library	D3D11.lib

Consulte también

ID3D11Device