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

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

구문

HRESULT OpenExistingHeapFromFileMapping(
        HANDLE hFileMapping,
        REFIID riid,
  [out] void   **ppvHeap
);

hFileMapping

형식: HANDLE

힙을 만드는 데 사용할 파일 매핑 개체에 대한 핸들입니다.

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 지역을 래핑합니다.

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