> ## 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](/zh-TW/reference/graphics/d3d12/structs/d3d12_subresource_footprint_public) 結構表示。

## 備註

此結構用於 [D3D12\_TEXTURE\_COPY\_LOCATION](/zh-TW/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public) 結構，
並由 [ID3D12Device::GetCopyableFootprints](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getcopyablefootprints_public) 使用。

使用量結構所參考的所有資料，都必須在父資源的範圍內。如果您使用 [GetCopyableFootprints](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getcopyablefootprints_public) 填寫結構，<i>pTotalBytes</i> 輸出欄位會指出資源的必要大小。

此結構也由許多協助程式函式使用 (請參閱 [D3D12 的協助程式結構和函式](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/helper-structures-and-functions-for-d3d12))。

複製紋理時，請將此結構與 [D3D12\_TEXTURE\_COPY\_LOCATION](/zh-TW/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 系列

## 另請參閱

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


## Related topics

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