Skip to main content
예약되었으며 아직 힙의 어떤 페이지에도 매핑되지 않은 리소스를 만듭니다.

구문

매개 변수

pDesc [in]
형식: const D3D12_RESOURCE_DESC *
리소스를 설명하는 D3D12_RESOURCE_DESC 구조체에 대한 포인터입니다. InitialState [in]
형식: D3D12_RESOURCE_STATES
D3D12_RESOURCE_STATES 열거형 상수의 비트 OR 조합으로 표현되는 리소스의 초기 상태입니다. pOptimizedClearValue [in, optional]
형식: const D3D12_CLEAR_VALUE *
지우기 색상의 기본값을 설명하는 D3D12_CLEAR_VALUE 구조체를 지정합니다. _pOptimizedClearValue_는 지우기 작업이 가장 최적화되는 값을 지정합니다. 생성된 리소스가 D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET 또는 D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL 플래그가 있는 텍스처인 경우, 지우기 작업이 가장 자주 호출될 값을 선택해야 합니다. 다른 값으로 지우기 작업을 호출할 수 있지만, 이러한 작업은 리소스 생성에 전달된 값과 일치하는 경우만큼 효율적이지 않습니다. D3D12_RESOURCE_DIMENSION_BUFFER를 사용하는 경우 _pOptimizedClearValue_를 nullptr로 설정해야 합니다. riid [in]
형식: const IID &
_ppvResource_에서 반환할 리소스 인터페이스의 전역 고유 식별자(GUID)에 대한 참조입니다. 설명을 참조하세요. _riidResource_는 가장 일반적으로 ID3D12ResourceGUID이지만, 모든 인터페이스의 GUID일 수 있습니다. 리소스 객체가 이 GUID에 대한 인터페이스를 지원하지 않으면 생성이 E_NOINTERFACE로 실패합니다. ppvResource [out, optional]
형식: void **
생성된 리소스 객체에 대한 요청된 인터페이스 포인터를 받는 메모리 블록에 대한 선택적 포인터입니다. _ppvResource_는 기능 테스트를 활성화하려면 nullptr일 수 있습니다. _ppvResource_가 nullptr인 경우 객체가 생성되지 않으며, _pDesc_가 유효하면 S_FALSE가 반환됩니다.

반환 값

형식: HRESULT 함수가 성공하면 S_OK를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다. 다른 가능한 반환 값은 Direct3D 12 반환 코드를 참조하세요.

설명

CreateReservedResource는 Direct3D 11의 D3D11_RESOURCE_MISC_TILED와 동등합니다. 백업 저장소가 없는 가상 메모리만 있는 리소스를 만듭니다. 리소스를 물리적 메모리(즉, 힙)에 매핑하려면 CopyTileMappingsUpdateTileMappings를 사용해야 합니다. 이러한 리소스 유형은 어댑터가 타일 리소스 계층 1 이상을 지원하는 경우에만 생성할 수 있습니다. 타일 리소스 계층은 힙에 매핑되지 않은 리소스에 액세스하는 동작을 정의합니다.

요구 사항

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

함께 보기

CreateCommittedResource CreatePlacedResource ID3D12Device
마지막 수정일 2026년 8월 24일