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

구문

매개 변수

NumDestDescriptorRanges [in]
형식: UINT
복사할 대상 디스크립터 범위의 수입니다. pDestDescriptorRangeStarts [in]
형식: const D3D12_CPU_DESCRIPTOR_HANDLE *
복사할 D3D12_CPU_DESCRIPTOR_HANDLE 객체 배열입니다. 모든 대상 및 원본 디스크립터는 동일한 D3D12_DESCRIPTOR_HEAP_TYPE의 힙에 있어야 합니다. pDestDescriptorRangeSizes [in, optional]
형식: const UINT *
복사할 대상 디스크립터 범위 크기의 배열입니다. NumSrcDescriptorRanges [in]
형식: UINT
복사할 원본 디스크립터 범위의 수입니다. pSrcDescriptorRangeStarts [in]
형식: const D3D12_CPU_DESCRIPTOR_HANDLE *
복사할 원본 D3D12_CPU_DESCRIPTOR_HANDLE 객체 배열입니다.
pSrcDescriptorRangeStarts 매개 변수의 모든 요소는 셰이더에서 볼 수 없는 디스크립터 힙에 있어야 합니다. 이는 셰이더에서 볼 수 있는 디스크립터 힙이 읽기가 매우 느린 WRITE_COMBINE 메모리 또는 GPU 로컬 메모리에 생성될 수 있기 때문입니다. 애플리케이션이 특정 패스나 프레임에 필요한 디스크립터를 로컬 “스토리지” 디스크립터 힙에서 GPU에 바인딩된 디스크립터 힙으로 복사하는 방식으로 디스크립터 힙을 관리하는 경우, 스토리지 힙에는 셰이더 불투명 힙을 사용하고 필요에 따라 GPU에서 볼 수 있는 힙에 복사하세요.
pSrcDescriptorRangeSizes [in, optional]
형식: const UINT *
복사할 원본 디스크립터 범위 크기의 배열입니다. DescriptorHeapsType [in]
형식: D3D12_DESCRIPTOR_HEAP_TYPE
복사할 디스크립터 힙의 유형을 지정하는 D3D12_DESCRIPTOR_HEAP_TYPE 형식의 값입니다. 서로 다른 디스크립터 유형은 다른 크기를 가질 수 있으므로 필요합니다. 원본과 대상 디스크립터 힙은 동일한 유형이어야 하며, 그렇지 않으면 디버그 레이어가 오류를 발생시킵니다.

반환 값

형식: void 없음.

설명

가능한 경우 이 메서드보다 ID3D12Device::CopyDescriptorsSimple을 사용하는 것이 좋습니다. 복사의 선형적 특성으로 인해 CPU 캐시 미스 비율이 더 나을 수 있습니다.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

함께 보기

디스크립터 복사 ID3D12Device
마지막 수정일 2026년 8월 24일