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

# CopyDescriptorsSimple

> 원본에서 대상으로 디스크립터를 복사합니다. (ID3D12Device.CopyDescriptorsSimple)

원본에서 대상으로 디스크립터를 복사합니다.

## 구문

```cpp theme={null}
void CopyDescriptorsSimple(
    UINT NumDescriptors,
    D3D12_CPU_DESCRIPTOR_HANDLE DestDescriptorRangeStart,
    D3D12_CPU_DESCRIPTOR_HANDLE SrcDescriptorRangeStart,
    D3D12_DESCRIPTOR_HEAP_TYPE DescriptorHeapsType
)
```

### 매개 변수

*NumDescriptors \[in]*\
형식: UINT

복사할 디스크립터의 수입니다.

*DestDescriptorRangeStart \[in]*\
형식: D3D12\_CPU\_DESCRIPTOR\_HANDLE

복사를 시작할 대상 디스크립터를 설명하는 \*\*[D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public)\*\*입니다.

대상 및 원본 디스크립터는 동일한 [D3D12\_DESCRIPTOR\_HEAP\_TYPE](/reference/graphics/d3d12/enums/d3d12_descriptor_heap_type_public)의 힙에 있어야 합니다.

*SrcDescriptorRangeStart \[in]*\
형식: D3D12\_CPU\_DESCRIPTOR\_HANDLE

복사를 시작할 원본 디스크립터를 설명하는 \*\*[D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public)\*\*입니다.

<Info>
  *SrcDescriptorRangeStart* 매개 변수는 셰이더에서 볼 수 없는 디스크립터 힙에 있어야 합니다. 이는 셰이더에서 볼 수 있는 디스크립터 힙이 읽기가 매우 느린 **WRITE\_COMBINE** 메모리 또는 GPU 로컬 메모리에 생성될 수 있기 때문입니다. 애플리케이션이 특정 패스나 프레임에 필요한 디스크립터를 로컬 “스토리지” 디스크립터 힙에서 GPU에 바인딩된 디스크립터 힙으로 복사하는 방식으로 디스크립터 힙을 관리하는 경우, 스토리지 힙에는 셰이더 불투명 힙을 사용하고 필요에 따라 GPU에서 볼 수 있는 힙에 복사하세요.
</Info>

*DescriptorHeapsType \[in]*\
형식: D3D12\_DESCRIPTOR\_HEAP\_TYPE

복사할 디스크립터 힙의 유형을 지정하는 [D3D12\_DESCRIPTOR\_HEAP\_TYPE](/reference/graphics/d3d12/enums/d3d12_descriptor_heap_type_public) 형식의 값입니다. 서로 다른 디스크립터 유형은 다른 크기를 가질 수 있으므로 필요합니다.

원본과 대상 디스크립터 힙은 동일한 유형이어야 하며, 그렇지 않으면 디버그 레이어가 오류를 발생시킵니다.

### 반환 값

형식: void

없음.

## 설명

가능한 경우 [**ID3D12Device::CopyDescriptors**](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptors_public)보다 이 메서드를 사용하는 것이 좋습니다. 복사의 선형적 특성으로 인해 CPU 캐시 미스 비율이 더 나을 수 있습니다.

## 요구 사항

**헤더:** 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/copying-descriptors)

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [CopyDescriptors](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptors_public.md)
- [D3D12_DESCRIPTOR_HEAP_TYPE](/ko/reference/graphics/d3d12/enums/d3d12_descriptor_heap_type_public.md)
- [D3D12_CPU_DESCRIPTOR_HANDLE](/ko/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [SetDescriptorHeaps](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public.md)
- [SimpleJson 라이선스](/ko/services/playfab/sdks/unity3d/Licenses/simplejson-license.md)