> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_RENDER_TARGET_VIEW_DESC

> 描述可通过使用渲染目标视图访问的资源中的子资源。

描述可通过使用渲染目标视图访问的资源中的子资源。

## 语法

```cpp theme={null}
typedef struct D3D12_RENDER_TARGET_VIEW_DESC
{
    DXGI_FORMAT Format;
    D3D12_RTV_DIMENSION ViewDimension;
    D3D12_BUFFER_RTV Buffer;
    D3D12_TEX1D_RTV Texture1D;
    D3D12_TEX1D_ARRAY_RTV Texture1DArray;
    D3D12_TEX2D_RTV Texture2D;
    D3D12_TEX2D_ARRAY_RTV Texture2DArray;
    D3D12_TEX2DMS_RTV Texture2DMS;
    D3D12_TEX2DMS_ARRAY_RTV Texture2DMSArray;
    D3D12_TEX3D_RTV Texture3D;
} D3D12_RENDER_TARGET_VIEW_DESC
```

### 成员

*Format*\
类型：DXGI\_FORMAT

一个 [DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format) 类型的值，指定查看格式。

*ViewDimension*\
类型：D3D12\_RTV\_DIMENSION

一个 [D3D12\_RTV\_DIMENSION](/reference/graphics/d3d12/enums/d3d12_rtv_dimension_public) 类型的值，指定如何访问渲染目标资源。此类型指定如何访问资源。此成员还确定要在以下联合中使用哪个 \_RTV。

*Buffer*\
类型：D3D12\_BUFFER\_RTV

一个 [D3D12\_BUFFER\_RTV](/reference/graphics/d3d12/structs/d3d12_buffer_rtv_public) 结构，指定可访问的缓冲区元素。

*Texture1D*\
类型：D3D12\_TEX1D\_RTV

一个 [D3D12\_TEX1D\_RTV](/reference/graphics/d3d12/structs/d3d12_tex1d_rtv_public) 结构，指定可访问的 1D 纹理中的子资源。

*Texture1DArray*\
类型：D3D12\_TEX1D\_ARRAY\_RTV

一个 [D3D12\_TEX1D\_ARRAY\_RTV](/reference/graphics/d3d12/structs/d3d12_tex1d_array_rtv_public) 结构，指定可访问的 1D 纹理数组中的子资源。

*Texture2D*\
类型：D3D12\_TEX2D\_RTV

一个 [D3D12\_TEX2D\_RTV](/reference/graphics/d3d12/structs/d3d12_tex2d_rtv_public) 结构，指定可访问的 2D 纹理中的子资源。

*Texture2DArray*\
类型：D3D12\_TEX2D\_ARRAY\_RTV

一个 [D3D12\_TEX2D\_ARRAY\_RTV](/reference/graphics/d3d12/structs/d3d12_tex2d_array_rtv_public) 结构，指定可访问的 2D 纹理数组中的子资源。

*Texture2DMS*\
类型：D3D12\_TEX2DMS\_RTV

一个 [D3D12\_TEX2DMS\_RTV](/reference/graphics/d3d12/structs/d3d12_tex2dms_rtv_public) 结构，指定单个子资源，因为多重采样的 2D 纹理只包含一个子资源。

*Texture2DMSArray*\
类型：D3D12\_TEX2DMS\_ARRAY\_RTV

一个 [D3D12\_TEX2DMS\_ARRAY\_RTV](/reference/graphics/d3d12/structs/d3d12_tex2dms_array_rtv_public) 结构，指定可访问的多重采样 2D 纹理数组中的子资源。

*Texture3D*\
类型：D3D12\_TEX3D\_RTV

一个 [D3D12\_TEX3D\_RTV](/reference/graphics/d3d12/structs/d3d12_tex3d_rtv_public) 结构，指定可访问的 3D 纹理中的子资源。

## 备注

将渲染目标视图描述传递给 [ID3D12Device::CreateRenderTargetView](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrendertargetview_public) 以创建渲染目标视图。

渲染目标视图不能使用以下格式：

<ul>
  <li>任何无类型格式。</li>
  <li>如果视图将用于绑定缓冲区（顶点、索引、常量或流输出），则不能使用 DXGI\_FORMAT\_R32G32B32。</li>
</ul>

如果格式设置为 DXGI\_FORMAT\_UNKNOWN，则将使用视图将其绑定到管线的资源的格式。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

[Core Structures](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [CreateRenderTargetView](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrendertargetview_public.md)
- [D3D12_RTV_DIMENSION](/zh-CN/reference/graphics/d3d12/enums/d3d12_rtv_dimension_public.md)
- [D3D12_BUFFER_RTV](/zh-CN/reference/graphics/d3d12/structs/d3d12_buffer_rtv_public.md)
- [D3D12_TEX3D_RTV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex3d_rtv_public.md)
- [D3D12_TEX1D_RTV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex1d_rtv_public.md)