ID3D12Device3::OpenExistingHeapFromAddress 메서드(d3d12.h)

주소에서 시스템 메모리에 특수 용도의 진단 힙을 만듭니다. 생성된 힙은 GPU 오류 또는 디바이스 제거 시나리오의 경우에도 지속될 수 있습니다.

구문

HRESULT OpenExistingHeapFromAddress(
  [in]  const void *pAddress,
        REFIID     riid,
  [out] void       **ppvHeap
);

[in] pAddress

형식: const void*

힙을 만드는 데 사용되는 주소입니다.

riid

형식: REFIID

힙 인터페이스(ID3D12Heap)에 대한 GUID(Globally Unique Identifier)입니다.

힙에 대한 인터페이스의 REFIID 또는 GUID는 __uuidof() 매크로를 사용하여 가져올 수 있습니다. 예를 들어 __uuidof(ID3D12Heap) 는 힙에 대한 인터페이스의 GUID 를 검색합니다.

[out] ppvHeap

형식: void**

SAL: COM_Outptr

메모리 블록에 대한 포인터입니다. 성공하면 D3D12 런타임은 새로 연 힙에 대한 포인터를 메모리 블록에 씁니다. 포인터의 형식은 제공된 riid 매개 변수에 따라 달라집니다.

형식: HRESULT

이 메서드는 기존 힙을 열 메모리가 부족한 경우 E_OUTOFMEMORY 반환합니다. 다른 가능한 반환 값은 Direct3D 12 반환 코드를 참조하세요.

힙은 시스템 메모리에 만들어지고 CPU 액세스를 허용합니다. 전체 VirtualAlloc 지역을 래핑합니다.

힙은 다른 힙과 직교적으로 배치 및 예약된 리소스에 사용할 수 있습니다. 앱에서 선택할 수 없는 플래그에 따라 제한 사항이 계속 존재할 수 있습니다.