> ## 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](/zh-TW/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)

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


## Related topics

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