ID3D12Device3::OpenExistingHeapFromFileMapping method (d3d12.h)
Membuat tumpukan diagnostik tujuan khusus dalam memori sistem dari objek pemetaan file. Tumpukan yang dibuat dapat bertahan bahkan jika terjadi kesalahan GPU atau skenario yang dihapus perangkat.
Sintaks
HRESULT OpenExistingHeapFromFileMapping(
HANDLE hFileMapping,
REFIID riid,
[out] void **ppvHeap
);
Parameter
hFileMapping
Jenis: HANDEL
Handel ke objek pemetaan file yang akan digunakan untuk membuat heap.
riid
Jenis: REFIID
Pengidentifikasi unik global (GUID) untuk antarmuka heap (ID3D12Heap).
REFIID, atau GUID, antarmuka ke heap dapat diperoleh dengan menggunakan makro __uuidof(). Misalnya, __uuidof(ID3D12Heap) akan mengambil GUID antarmuka ke heap.
[out] ppvHeap
Jenis: batal**
SAL: COM_Outptr
Penunjuk ke blok memori. Setelah berhasil, runtime D3D12 akan menulis pointer ke tumpukan yang baru dibuka ke blok memori. Jenis pointer tergantung pada parameter riid yang disediakan.
Nilai kembali
Jenis: HRESULT
Metode ini mengembalikan E_OUTOFMEMORY jika tidak ada cukup memori untuk membuka timbunan yang ada. Lihat Kode Pengembalian Direct3D 12 untuk kemungkinan nilai pengembalian lainnya.
Keterangan
Timbunan dibuat dalam memori sistem, dan memungkinkan akses CPU. Ini membungkus seluruh wilayah VirtualAlloc.
Timbunan dapat digunakan untuk sumber daya yang ditempatkan dan dipesan, sebagaimana secara ortogonal seperti timbunan lainnya. Pembatasan mungkin masih ada berdasarkan bendera yang tidak dapat dipilih aplikasi.
Persyaratan
| Klien minimum yang didukung | Windows 10 Build 20348 |
| Server minimum yang didukung | Windows 10 Build 20348 |
| Target Platform | Windows |
| Header | d3d12.h |
| Pustaka | D3d12.lib |
| DLL | D3d12.dll |