ID3D12Device3::OpenExistingHeapFromAddress method (d3d12.h)

Artikel
08/23/2023

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

Lihat juga

Antarmuka ID3D12Device3

Share via