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

> 描述用于纹理复制的纹理部分。

描述用于纹理复制的纹理部分。

## 语法

```cpp theme={null}
typedef struct D3D12_TEXTURE_COPY_LOCATION
{
    ID3D12Resource  pResource;
    D3D12_TEXTURE_COPY_TYPE Type;
    D3D12_PLACED_SUBRESOURCE_FOOTPRINT PlacedFootprint;
    UINT SubresourceIndex;
} D3D12_TEXTURE_COPY_LOCATION
```

### 成员

*pResource*\
类型：ID3D12Resource \*

指定用于复制操作的资源。<div> </div>当 **Type** 为 D3D12\_TEXTURE\_COPY\_TYPE\_PLACED\_FOOTPRINT 时，**pResource** 必须指向缓冲区资源。<div> </div>当 **Type** 为 D3D12\_TEXTURE\_COPY\_TYPE\_SUBRESOURCE\_INDEX 时，**pResource** 必须指向纹理资源。

*Type*\
类型：D3D12\_TEXTURE\_COPY\_TYPE

指定此资源位置的类型：纹理的子资源，或者可应用于缓冲区的纹理布局描述。
此 [D3D12\_TEXTURE\_COPY\_TYPE](/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public) 枚举指示要使用哪个联合体成员。

*PlacedFootprint*\
类型：D3D12\_PLACED\_SUBRESOURCE\_FOOTPRINT

指定纹理布局，包括偏移量、维度和间距，以便硬件了解如何将缓冲区资源的某个部分视为多维纹理。
要为 [CopyTextureRegion](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytextureregion_public) 调用填充正确数据，
请参阅 [D3D12\_PLACED\_SUBRESOURCE\_FOOTPRINT](/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public)。

*SubresourceIndex*\
类型：UINT

指定要用于复制操作的数组、映射 mip 或平面纹理的子资源索引。

## 备注

将此结构与 [CopyTextureRegion](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytextureregion_public) 一起使用。

## 要求

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

## 另请参阅

[CD3DX12\_TEXTURE\_COPY\_LOCATION](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-texture-copy-location)

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

[D3D12\_PLACED\_SUBRESOURCE\_FOOTPRINT](/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public)


## Related topics

- [D3D12_TEXTURE_COPY_TYPE](/zh-CN/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_PLACED_SUBRESOURCE_FOOTPRINT](/zh-CN/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public.md)
- [D3D12_TEXTURE_BARRIER (XBOX Series consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)
- [D3D12_VIEW_INSTANCE_LOCATION](/zh-CN/reference/graphics/d3d12/structs/d3d12_view_instance_location_public.md)
- [D3D12_TILE_COPY_FLAGS](/zh-CN/reference/graphics/d3d12/enums/d3d12_tile_copy_flags_public.md)