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

> 특정 리소스의 지우기(clear) 작업을 최적화하는 데 사용되는 값을 설명합니다.

특정 리소스의 지우기(clear) 작업을 최적화하는 데 사용되는 값을 설명합니다.

## 구문

```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) 열거형의 한 멤버를 지정합니다.

일반적으로 지워지는 색의 형식은 뷰/설명자 생성과 동일한 유효성 검사 규칙을 따릅니다. 일반적으로 지우기 색의 형식은 리소스 형식이 속하는 동일한 형식 없는(typeless) 그룹의 모든 형식일 수 있습니다.

이 <i>Format</i>은 지우기 작업 중에 사용되는 뷰의 형식과 일치해야 합니다. 이는 <i>Color</i> 또는 <i>DepthStencil</i> 멤버 중 어느 것이 유효한지, 그리고 리소스에서 사용하기 위해 값을 어떻게 변환할지를 나타냅니다.

*Color*\
형식: FLOAT\[4]

RGBA 값을 결정하는 float 값의 4항목 배열을 지정합니다. RGBA 순서는 [ClearRenderTargetView](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/methods/id3d12graphicscommandlist_clearrendertargetview_xs)에서 사용되는 순서와 일치합니다.

*DepthStencil*\
형식: D3D12\_DEPTH\_STENCIL\_VALUE

[D3D12\_DEPTH\_STENCIL\_VALUE](/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public)의 한 멤버를 지정합니다. 이 값들은 [ClearDepthStencilView](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_cleardepthstencilview_public)의 <i>Depth</i> 및 <i>Stencil</i>의 의미와 일치합니다.

## 설명

이 구조체는 다음 메서드에 선택적으로 전달됩니다:

<ul>
  <li>
    [ID3D12Device::CreateCommittedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public)
  </li>

  <li>
    [ID3D12Device::CreatePlacedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public)
  </li>

  <li>
    [ID3D12Device::CreateReservedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public)
  </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](/ko/reference/graphics/d3d12/structs/d3d12_render_pass_beginning_access_clear_parameters_public.md)
- [D3D12_DEPTH_STENCIL_VALUE](/ko/reference/graphics/d3d12/structs/d3d12_depth_stencil_value_public.md)
- [CreateReservedResource](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
- [CreateReservedResource1 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)
- [CreateCommittedResource](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)