> ## 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_TEXCUBE_SRV

> 描述用于着色器资源视图的立方体纹理中的子资源。

描述用于着色器资源视图的立方体纹理中的子资源。

## 语法

```cpp theme={null}
typedef struct D3D12_TEXCUBE_SRV
{
    UINT MostDetailedMip;
    UINT MipLevels;
    FLOAT ResourceMinLODClamp;
} D3D12_TEXCUBE_SRV
```

### 成员

*MostDetailedMip*\
类型：UINT

要使用的最详细 mipmap 层级的索引；该值介于 0 与 **MipLevels**（来自 [ID3D12Device::CreateShaderResourceView](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createshaderresourceview_public) 创建视图的原始 TextureCube）-1 之间。

*MipLevels*\
类型：UINT

该纹理视图的 mipmap 层级最大数量。请参阅 [D3D12\_TEX1D\_SRV](/reference/graphics/d3d12/structs/d3d12_tex1d_srv_public) 中的备注。

设置为 -1 表示使用从 **MostDetailedMip** 到最不详细的所有 mipmap 层级。

*ResourceMinLODClamp*\
类型：FLOAT

指定可以访问的最小 mipmap 层级。指定 0.0f 表示可以访问所有 mipmap 层级。指定 3.0f 表示可以访问从 3.0f 到 *MipCount - 1* 的 mipmap 层级。

建议不要同时设置 *MostDetailedMip* 和 *ResourceMinLODClamp*。请将其中一个成员设为 0（以获得默认行为）。这是因为 *MipLevels* 与不同字段结合时具有不同的解释：

* 对于 *MostDetailedMip*，mip 范围为 \[*MostDetailedMip*，*MostDetailedMip* + *MipLevels* - 1]。
* 对于 *ResourceMinLODClamp*，mip 范围为 \[*ResourceMinLODClamp*，*MipLevels* - 1]。

## 备注

此结构是着色器资源视图说明 [D3D12\_SHADER\_RESOURCE\_VIEW\_DESC](/reference/graphics/d3d12/structs/d3d12_shader_resource_view_desc_public) 的成员之一。

## 要求

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

## 另请参阅

[核心结构](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_SHADER_RESOURCE_VIEW_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_shader_resource_view_desc_public.md)
- [D3D12_TEXCUBE_ARRAY_SRV](/zh-CN/reference/graphics/d3d12/structs/d3d12_texcube_array_srv_public.md)
- [D3D12_BUFFER_SRV](/zh-CN/reference/graphics/d3d12/structs/d3d12_buffer_srv_public.md)
- [D3D12_TEX1D_SRV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex1d_srv_public.md)
- [D3D12_TEX2D_SRV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex2d_srv_public.md)