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

> 描述子资源在父资源中的格式、宽度、高度、深度和行间距。

描述子资源在父资源中的格式、宽度、高度、深度和行间距。

## 语法

```cpp theme={null}
typedef struct D3D12_SUBRESOURCE_FOOTPRINT
{
    DXGI_FORMAT Format;
    UINT Width;
    UINT Height;
    UINT Depth;
    UINT RowPitch;
} D3D12_SUBRESOURCE_FOOTPRINT
```

### 成员

*Format*\
类型：DXGI\_FORMAT

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

*Width*\
类型：UINT

子资源的宽度。

*Height*\
类型：UINT

子资源的高度。

*Depth*\
类型：UINT

子资源的深度。

*RowPitch*\
类型：UINT

子资源数据的行间距、宽度或物理大小（以字节为单位）。
此值必须是 D3D12\_TEXTURE\_DATA\_PITCH\_ALIGNMENT (256) 的倍数，并且必须大于或等于一行内数据的大小。

## 备注

在 [D3D12\_PLACED\_SUBRESOURCE\_FOOTPRINT](/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public) 结构中使用此结构。

辅助结构为 [CD3DX12\_SUBRESOURCE\_FOOTPRINT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-subresource-footprint)。

## 要求

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

## 另请参阅

[CD3DX12\_SUBRESOURCE\_FOOTPRINT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-subresource-footprint)

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


## Related topics

- [D3D12_PLACED_SUBRESOURCE_FOOTPRINT](/zh-CN/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public.md)
- [GetCopyableFootprints](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getcopyablefootprints_public.md)
- [D3D12_TEXTURE_COPY_TYPE](/zh-CN/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_TEXTURE_COPY_LOCATION](/zh-CN/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_SUBRESOURCE_DATA](/zh-CN/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)