Fungsi D3DKMTMapGpuVirtualAddress (d3dkmthk.h)

  • Artikel

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

Lihat juga

DxgkCbReserveGpuVirtualAddressRange