다음을 통해 공유


ID3D12Device10::CreateCommittedResource3 메서드(d3d12.h)

초기 상태가 아닌 초기 레이아웃으로 커밋된 리소스를 만듭니다.

DirectX 12 Agility SDK 1.7 이상이 필요합니다.

통사론

HRESULT CreateCommittedResource3(
  const D3D12_HEAP_PROPERTIES    *pHeapProperties,
  D3D12_HEAP_FLAGS               HeapFlags,
  const D3D12_RESOURCE_DESC1     *pDesc,
  D3D12_BARRIER_LAYOUT           InitialLayout,
  const D3D12_CLEAR_VALUE        *pOptimizedClearValue,
  ID3D12ProtectedResourceSession *pProtectedSession,
  UINT32                         NumCastableFormats,
  const DXGI_FORMAT              *pCastableFormats,
  REFIID                         riidResource,
  void                           **ppvResource
);

매개 변수

pHeapProperties

형식: _In_ const D3D12_HEAP_PROPERTIES*

리소스의 힙에 대한 속성을 제공하는 D3D12_HEAP_PROPERTIES 구조체에 대한 포인터입니다.

HeapFlags

형식: D3D12_HEAP_FLAGS

D3D12_HEAP_FLAGS 열거형 상수의 비트 OR 조합인 힙 옵션입니다.

pDesc

형식: const D3D12_RESOURCE_DESC1*

mip 영역을 포함하여 리소스를 설명하는 D3D12_RESOURCE_DESC1 구조체에 대한 포인터입니다.

InitialLayout

텍스처 리소스의 초기 레이아웃입니다. 버퍼에 대한 D3D12_BARRIER_LAYOUT::D 3D12_BARRIER_LAYOUT_UNDEFINED.

pOptimizedClearValue

형식: const D3D12_CLEAR_VALUE*

명확한 색의 기본값을 설명하는 D3D12_CLEAR_VALUE 구조를 지정합니다.

pOptimizedClearValue 명확한 작업이 가장 최적인 값을 지정합니다. 생성된 리소스가 D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET 또는 D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL 플래그가 있는 텍스처인 경우 clear 작업이 가장 일반적으로 호출되는 값을 선택해야 합니다. 다른 값으로 지우기 작업을 호출할 수 있지만 해당 작업은 값이 리소스 생성에 전달된 값과 일치하는 경우만큼 효율하지 않습니다.

D3D12_RESOURCE_DIMENSION_BUFFER사용하는 경우 pOptimizedClearValuenullptr설정해야 합니다.

pProtectedSession

형식: ID3D12ProtectedResourceSession*

콘텐츠 보호를 위한 세션을 나타내는 개체에 대한 선택적 포인터입니다. 제공된 경우 이 세션은 리소스를 보호해야 임을 나타냅니다. ID3D12Device4::CreateProtectedResourceSession호출하여 ID3D12ProtectedResourceSession 가져올 수 있습니다.

NumCastableFormats

pCastableFormats의 요소 수는.

pCastableFormats

이 리소스를 캐스팅할 수 있는 연속된 DXGI_FORMAT 구조 배열입니다.

riidResource

형식: REFIID

ppvResource반환할 리소스 인터페이스의 전역 고유 식별자(GUID)에 대한 참조입니다.

riidResource 가장 일반적으로 ID3D12ResourceGUID, 모든 인터페이스의 GUID 수 있습니다. 리소스 개체가 이 GUID대한 인터페이스를 지원하지 않으면 E_NOINTERFACE생성에 실패합니다.

ppvResource

형식: void**

생성된 리소스 개체에 대한 요청된 인터페이스 포인터를 수신하는 메모리 블록에 대한 선택적 포인터입니다.

ppvResourcenullptr기능 테스트를 사용하도록 설정할 수 있습니다. ppvResource 경우 개체가 만들어지지 않으며 pDesc 유효한 경우 S_FALSE 반환됩니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK반환합니다. 그렇지 않으면 HRESULT오류 코드반환합니다.

반환 값 묘사
E_OUTOFMEMORY 리소스를 만들 메모리가 부족합니다.

다른 가능한 반환 값은 Direct3D 12 반환 코드 참조하세요.

요구 사항

요구
대상 플랫폼 Windows
헤더 d3d12.h
라이브러리 D3d12.lib
DLL D3d12.dll

참고 항목

ID3D12Device10