ID3D12Device3::OpenExistingHeapFromAddress method (d3d12.h)
Membuat tumpukan diagnostik tujuan khusus dalam memori sistem dari alamat. Tumpukan yang dibuat dapat bertahan bahkan jika terjadi kesalahan GPU atau skenario yang dihapus perangkat.
Sintaks
HRESULT OpenExistingHeapFromAddress(
[in] const void *pAddress,
REFIID riid,
[out] void **ppvHeap
);
Parameter
[in] pAddress
Jenis: const void*
Alamat yang digunakan untuk membuat timbunan.
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 mengizinkan 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
Target Platform | Windows |
Header | d3d12.h |
Pustaka | D3d12.lib |
DLL | D3d12.dll |