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

> 描述一个 3D 框。

描述一个 3D 框。

## 语法

```cpp theme={null}
typedef struct D3D12_BOX
{
    UINT left;
    UINT top;
    UINT front;
    UINT right;
    UINT bottom;
    UINT back;
} D3D12_BOX
```

### 成员

*left*\
类型：UINT

框的左侧的 x 位置。

*top*\
类型：UINT

框的顶部的 y 位置。

*front*\
类型：UINT

框的前面的 z 位置。

*right*\
类型：UINT

框的右侧的 x 位置，加 1。这意味着 <code>right - left</code> 等于框的宽度。

*bottom*\
类型：UINT

框的底部的 y 位置，加 1。这意味着 <code>bottom - top</code> 等于框的高度。

*back*\
类型：UINT

框的后面的 z 位置，加 1。这意味着 <code>back - front</code> 等于框的深度。

## 备注

此结构由 [WriteToSubresource](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_writetosubresource_public)、[ReadFromSubresource](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_readfromsubresource_public) 和 [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\_BOX](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-box)

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


## Related topics

- [ReadFromSubresource](/zh-CN/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_readfromsubresource_public.md)
- [D3D12_TILE_REGION_SIZE](/zh-CN/reference/graphics/d3d12/structs/d3d12_tile_region_size_public.md)
- [D3D12_FEATURE](/zh-CN/reference/graphics/d3d12/enums/d3d12_feature_public.md)
- [D3D12_BLEND](/zh-CN/reference/graphics/d3d12/enums/d3d12_blend_public.md)
- [D3D12_FILTER](/zh-CN/reference/graphics/d3d12/enums/d3d12_filter_public.md)