Fungsi D3DKMTMapGpuVirtualAddress (d3dkmthk.h)
D3DKMTMapGpuVirtualAddress memetakan rentang alamat virtual GPU ke rentang alokasi tertentu atau menempatkannya ke status Tidak Valid atau Nol .
Sintaks
NTSTATUS D3DKMTMapGpuVirtualAddress(
D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam1
);
Parameter
unnamedParam1
[masuk/keluar] pData adalah penunjuk ke struktur D3DDDI_MAPGPUVIRTUALADDRESS yang menjelaskan operasi.
Nilai kembali
Menampilkan kode | Deskripsi |
---|---|
STATUS_SUCCESS | Konteks perangkat berhasil dibuat. |
STATUS_INVALID_PARAMETER | Parameter divalidasi dan ditentukan salah. |
Fungsi ini mungkin juga mengembalikan nilai NTSTATUS lainnya.
Keterangan
Driver dapat menentukan alamat virtual GPU dasar (VA) untuk memetakan atau membiarkan manajer memori video secara otomatis memilih satu. Saat menentukan nilai BaseAddress non-NULL, seluruh rentang dari BaseAddress ke Ukuran BaseAddress+ harus dalam keadaan dibebaskan atau termasuk dalam rentang VA yang diperoleh dengan memanggil D3DKMTMapGpuVirtualAddress atau DxgkCbReserveGpuVirtualAddressRange. Ketika Protection.Zero atau Protection.NoAccess ditentukan, rentang VA tidak dapat termasuk dalam rentang yang diperoleh dengan memanggil MapGpuVirtualAddressCb.
Driver dapat menentukan apakah pemetaan harus memungkinkan untuk menulis dan menjalankan hak istimewa selain hak istimewa baca, yang selalu ada secara default.
Dalam konfigurasi adaptor tampilan tertaut (LDA), antrean halaman menentukan GPU fisik yang tabel halamannya dimodifikasi, dan handel alokasi (jika tidak NULL) menentukan tempat entri tabel halaman menunjuk. Alokasi dapat menjadi residen di segmen memori GPU fisik apa pun.
Rentang GPU VA, yang dialokasikan oleh API, dikosongkan ketika alokasi (VA GPU dipetakan ke) dihancurkan. Rentang VA juga dapat dibebaskan dengan memanggil D3DKMTFreeGpuVirtualAddress, tetapi ini perlu disinkronkan dengan penghancuran alokasi jika perlu.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 |
Server minimum yang didukung | Server Windows 2016 |
Target Platform | Universal |
Header | d3dkmthk.h (termasuk D3dkmthk.h) |
Pustaka | Gdi32.lib |
DLL | Gdi32.dll |