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

> 描述放置子资源的占用空间，包括偏移量和 D3D12_SUBRESOURCE_FOOTPRINT。

描述放置子资源的占用空间，包括偏移量和 D3D12\_SUBRESOURCE\_FOOTPRINT。

## 语法

```cpp theme={null}
typedef struct D3D12_PLACED_SUBRESOURCE_FOOTPRINT
{
    UINT64 Offset;
    D3D12_SUBRESOURCE_FOOTPRINT Footprint;
} D3D12_PLACED_SUBRESOURCE_FOOTPRINT
```

### 成员

*Offset*\
类型：UINT64

子资源在父资源中的偏移量（以字节为单位）。
父资源开始处与此子资源之间的偏移量。

*Footprint*\
类型：D3D12\_SUBRESOURCE\_FOOTPRINT

子资源的格式、宽度、高度、深度和行间距，
作为 [D3D12\_SUBRESOURCE\_FOOTPRINT](/reference/graphics/d3d12/structs/d3d12_subresource_footprint_public) 结构。

## 备注

此结构在 [D3D12\_TEXTURE\_COPY\_LOCATION](/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public) 结构中使用，
以及由 [ID3D12Device::GetCopyableFootprints](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getcopyablefootprints_public) 使用。

占用空间结构引用的所有数据必须在父资源的边界内。如果使用 [GetCopyableFootprints](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getcopyablefootprints_public) 填写该结构，则 <i>pTotalBytes</i> 输出字段指示所需的资源大小。

此结构还由许多辅助函数使用（请参阅 [Helper Structures and Functions for D3D12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/helper-structures-and-functions-for-d3d12)）。

复制纹理时，将此结构与 [D3D12\_TEXTURE\_COPY\_LOCATION](/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public) 一起使用。

## 要求

**头文件：** 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

- [D3D12_SUBRESOURCE_FOOTPRINT](/zh-CN/reference/graphics/d3d12/structs/d3d12_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)