> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_CLEAR_VALUE

> 特定のリソースに対するクリア操作を最適化するために使用される値を記述します。

特定のリソースに対するクリア操作を最適化するために使用される値を記述します。

## 構文

```cpp theme={null}
typedef struct D3D12_CLEAR_VALUE
{
    DXGI_FORMAT Format;
    FLOAT Color;
    D3D12_DEPTH_STENCIL_VALUE DepthStencil;
} D3D12_CLEAR_VALUE
```

### メンバー

*Format*\
型: DXGI\_FORMAT

[DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format) 列挙型のメンバーの 1 つを指定します。

一般的にクリアされる色のフォーマットは、ビュー/デスクリプター作成と同じ検証規則に従います。一般に、クリア カラーのフォーマットは、リソース フォーマットが属する同じ型指定なしグループ内の任意のフォーマットにできます。

この *Format* は、クリア操作中に使用されるビューのフォーマットと一致する必要があります。これは、*Color* メンバーと *DepthStencil* メンバーのどちらが有効か、およびリソースでの使用のために値をどのように変換するかを示します。

*Color*\
型: FLOAT\[4]

RGBA 値を決定する、float 値の 4 要素配列を指定します。RGBA の順序は、[ClearRenderTargetView](https://docs.xbox.com/ja-jp/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/methods/id3d12graphicscommandlist_clearrendertargetview_xs.md) で使用される順序と一致します。

*DepthStencil*\
型: D3D12\_DEPTH\_STENCIL\_VALUE

[D3D12\_DEPTH\_STENCIL\_VALUE](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public.md) のメンバーの 1 つを指定します。これらの値は、[ClearDepthStencilView](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_cleardepthstencilview_public.md) の *Depth* および *Stencil* のセマンティクスと一致します。

## 解説

この構造体は、次のメソッドにオプションで渡されます。

<ul>
  <li>
    [ID3D12Device::CreateCommittedResource](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)
  </li>

  <li>
    [ID3D12Device::CreatePlacedResource](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
  </li>

  <li>
    [ID3D12Device::CreateReservedResource](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
  </li>
</ul>

## 要件

**ヘッダー:** d3d12\_xs.h または d3d12\_x.h\
**ライブラリ:** d3d12\_xs.lib または d3d12\_x.lib\
**サポートされるプラットフォーム**: XBOX Series 本体および XBOX One ファミリ

## 関連項目

[CD3DX12\_CLEAR\_VALUE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-clear-value)

[コア構造体](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_RENDER_PASS_BEGINNING_ACCESS_CLEAR_PARAMETERS](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/structs/d3d12_render_pass_beginning_access_clear_parameters_public.md)
- [D3D12_DEPTH_STENCIL_VALUE](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public.md)
- [CreateReservedResource](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
- [CreateReservedResource1 (XBOX Series 本体)](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)
- [CreateCommittedResource](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)