struktur DXGKARGCB_MAPFRAMEBUFFERPOINTER (d3dkmddi.h)

  • Artikel

Struktur DXGKARGCB_MAPFRAMEBUFFERPOINTER berisi argumen yang digunakan oleh fungsi panggilan balik DXGKCB_MAPFRAMEBUFFERPOINTER untuk memetakan penunjuk buffer bingkai.

Sintaks

typedef struct _DXGKARGCB_MAPFRAMEBUFFERPOINTER {
  [in]     UINT   PhysicalAdapterIndex;
  [in]     SIZE_T Size;
  [in/out] SIZE_T Offset;
  [out]    PVOID  pBaseAddress;
} DXGKARGCB_MAPFRAMEBUFFERPOINTER;

Anggota

[in] PhysicalAdapterIndex

Indeks adaptor fisik.

[in] Size

Ukuran, dalam byte, dari subregion objek bagian yang dipetakan. Ukuran harus kelipatan PAGE_SIZE.

[in/out] Offset

Pada input, ini adalah offset, dalam byte, ke subregion objek bagian yang dipetakan. Offset harus kelipatan PAGE_SIZE. Pada output, ini adalah offset dari alamat dasar output tempat driver harus menyalin data.

[out] pBaseAddress

Penunjuk alamat dasar yang dapat diakses CPU ke subregion objek bagian yang dipetakan. Driver harus menambahkan nilai Offset output ke alamat dasar untuk mendapatkan alamat tujuan operasi salin apa pun (pDestinationAddress = pBaseAddress + Offset).

Keterangan

Jika menyematkan seluruh objek bagian buffer bingkai gagal, driver harus mencoba memastikan kemajuan maju dengan melakukan transfer dalam potongan yang lebih kecil. Ini dicapai dengan mengalokasikan MDL kecil atau potongan memori selama waktu inisialisasi yang dapat digunakan untuk mentransfer konten dari perangkat keras, dan kemudian memanggil DXGKCB_MAPFRAMEBUFFERPOINTER untuk mendapatkan penunjuk ke subregensi objek bagian.

Driver bertanggung jawab untuk menyalin data dari buffer yang telah dialokasikan sebelumnya ke subregion yang dipetakan. Kebalikannya juga berlaku saat memulihkan konten buffer bingkai.

Lihat Isolasi GPU berbasis IOMMU untuk informasi selengkapnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1803 (WDDM 2.4)
Header d3dkmddi.h

Lihat juga

DXGKCB_MAPFRAMEBUFFERPOINTER