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 지역을 래핑합니다.
힙은 배치된 리소스 및 예약된 리소스에 다른 힙과 직교적으로 사용할 수 있습니다. 앱에서 선택할 수 없는 플래그에 따라 제한 사항이 계속 존재할 수 있습니다.
요구 사항
지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
지원되는 최소 서버 | Windows 10 빌드 20348 |
대상 플랫폼 | Windows |
헤더 | d3d12.h |
라이브러리 | D3d12.lib |
DLL | D3d12.dll |