Skip to main content
명령 목록과 연결된 현재 바인딩된 설명자 힙을 변경합니다.

구문

매개 변수

NumDescriptorHeaps
형식: UINT
바인딩할 설명자 힙의 개수입니다. ppDescriptorHeaps
형식: [in] ID3D12DescriptorHeap*
명령 목록에 설정할 힙에 대한 ID3D12DescriptorHeap 개체 배열에 대한 포인터입니다. D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAVD3D12_DESCRIPTOR_HEAP_TYPE_SAMPLER 유형의 설명자 힙만 바인딩할 수 있습니다. 각 유형의 설명자 힙은 한 번에 하나만 설정할 수 있으므로, 한 번에 최대 2개의 힙(샘플러 하나, CBV/SRV/UAV 하나)만 설정할 수 있습니다.

반환 값

형식: void 없음.

설명

SetDescriptorHeaps는 번들에서 호출할 수 있지만, 번들 설명자 힙은 호출하는 명령 목록의 설명자 힙과 일치해야 합니다. 번들 제한에 대한 자세한 내용은 명령 목록 및 번들 만들기 및 기록을 참조하세요. 이전에 설정된 모든 힙은 이 호출로 인해 설정 해제됩니다. 이 호출에서는 셰이더 표시 유형별로 최대 하나의 힙만 설정할 수 있습니다. 설명자 힙 변경은 일부 하드웨어에서 파이프라인 플러시를 초래할 수 있습니다. 이 때문에 각 유형별로 하나의 셰이더 표시 힙을 사용하고 프레임당 한 번만 설정하는 것이 권장되며, 바인딩된 설명자 힙을 자주 변경하지 않는 것이 좋습니다. 대신, 렌더링 중에 필요에 따라 셰이더 불투명 힙에서 단일 셰이더 표시 힙으로 필요한 설명자를 복사하려면 ID3D12Device::CopyDescriptorsID3D12Device::CopyDescriptorsSimple을 사용하세요.

예제

D3D12Bundles 샘플에서는 ID3D12GraphicsCommandList::SetDescriptorHeaps를 다음과 같이 사용합니다:
D3D12 참조의 예제 코드를 참조하세요.

요구 사항

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

함께 보기

설명자 힙 ID3D12GraphicsCommandList
마지막 수정일 2026년 8월 24일