struktur DXGKARGCB_MAP_PHYSICAL_MEMORY (d3dkmddi.h)

Artikel
03/10/2023

Struktur DXGKARGCB_MAP_PHYSICAL_MEMORY berisi informasi yang digunakan oleh fungsi panggilan balik DXGKCB_MAPPHYSICALMEMORY untuk memetakan alamat virtual yang terlihat CPU ke memori fisik yang mendasar.

Sintaks

typedef struct _DXGKARGCB_MAP_PHYSICAL_MEMORY {
  [in]     HANDLE           hPhysicalMemoryObject;
  [in]     DXGK_ACCESS_MODE AccessMode;
  [in/out] SIZE_T           Offset;
  [in]     SIZE_T           Size;
  [out]    void             *pMappedAddress;
} DXGKARGCB_MAP_PHYSICAL_MEMORY;

Anggota

[in] hPhysicalMemoryObject

Objek memori fisik yang menjelaskan halaman fisik yang mendasar untuk dipetakan. Objek ini dibuat dalam panggilan sebelumnya ke DXGKCB_CREATEPHYSICALMEMORYOBJECT.

[in] AccessMode

Nilai enum DXGK_ACCESS_MODE yang menjelaskan mode akses (mode pengguna atau mode kernel) tempat pemetaan harus dibuat.

[in/out] Offset

Sebagai input, menentukan offset dari awal objek memori fisik, dalam byte. Sebagai output, menentukan offset dari awal alamat dasar yang dipetakan tempat data yang diminta berada, dalam byte. Lihat Keterangan untuk informasi selengkapnya.

[in] Size

Sebagai input, menentukan ukuran wilayah yang diminta, dalam byte. Sebagai output, menentukan ukuran aktual yang dipetakan, dalam byte. Lihat Keterangan untuk informasi selengkapnya.

[out] pMappedAddress

Pada panggilan yang berhasil untuk DXGKCB_MAPPHYSICALMEMORY, ini adalah penunjuk ke pemetaan memori fisik yang mendasar. Awal rentang memori yang dipetakan mungkin tidak sama persis dengan offset yang diminta oleh driver jika pembulatan atau penyelarasan diperlukan. Akibatnya, nilai output Offset mengacu pada offset dari alamat dasar ke data yang diminta oleh driver. Artinya, ActualAddress = BaseAddress + Offset.

Keterangan

Offset dan Ukuran adalah parameter input dan output. Sebagai input, ini menjelaskan wilayah memori fisik yang diminta oleh pemanggil. Pada output, ini menjelaskan tampilan yang dipetakan aktual. Ini karena alamat yang dipetakan ke memori fisik yang sesuai mungkin tidak persis pada offset yang diminta. Data aktual yang diminta oleh pemanggil akan sama dengan pMappedAddress + Offset. Ukuran rentang alamat virtual yang dipetakan akan menjadi nilai output Ukuran, yang mungkin lebih besar dari ukuran yang diminta.

Lihat remapping IOMMU DMA untuk informasi selengkapnya.

Persyaratan

Persyaratan	Nilai
Server minimum yang didukung	Windows Server 2022 (WDDM 2.9)
Header	d3dkmddi.h

Lihat juga

DXGK_ACCESS_MODE

DXGKCB_MAPPHYSICALMEMORY

Bagikan melalui