struktur DXGK_IOMMU_CAPS (d3dkmddi.h)

Artikel
02/26/2024

Struktur DXGK_IOMMU_CAPS digunakan untuk menunjukkan apakah driver mendukung pemetakan ulang linier IOMMU.

Sintaks

typedef struct _DXGK_IOMMU_CAPS {
  union {
    struct {
      UINT32 IommuIsolationSupported : 1;
      UINT32 IommuIsolationRequired : 1;
      UINT32 DmaRemappingSupported : 1;
      UINT32 Reserved : 29;
    };
    UINT32 Value;
  };
} DXGK_IOMMU_CAPS;

Anggota

IommuIsolationSupported

Menunjukkan bahwa driver mendukung isolasi IOMMU, dan sepenuhnya menggunakan API panggilan balik IOMMU untuk memetakan objek memori yang dialokasikan driver ke domain IOMMU. Bidang ini menirukan DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeSupported. Dxgkrnl mengharapkan kemampuan ini untuk dicocokkan.

IommuIsolationRequired

Menunjukkan bahwa IOMMU diperlukan agar perangkat keras berfungsi dengan benar dan aman. Jika IOMMU tidak ada pada sistem atau domain tidak dapat dilampirkan ke perangkat, perangkat tidak akan dimulai. Bidang ini menirukan DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeRequired. Dxgkrnl mengharapkan kemampuan ini untuk dicocokkan.

DmaRemappingSupported

Menunjukkan bahwa pemetaan ulang linier didukung oleh driver, dan bukan hanya pemetaan 1:1 yang digunakan untuk isolasi standar. Jika beberapa adaptor fisik yang ditautkan memiliki nilai yang berbeda untuk alamat tertinggi yang terlihat, driver harus melaporkan nilai minimum semua adaptor fisik.

Reserved

Dipesan; jangan gunakan.

Value

Metode alternatif untuk mengakses bit.

Keterangan

Driver mengisi struktur ini ketika Dxgkrnl memanggil DxgkDdiQueryAdapterInfo dengan nilai DXGK_QUERYADAPTERINFOTYPE DXGKQAITYPE_IOMMU_CAPS. Dxgkrnl akan memanggil DxgkDdiQueryAdapterInfo setelah DxgkddiAddDevice dipanggil untuk semua adaptor fisik, tetapi sebelum DxgkddiStartDevice. Driver diharapkan untuk mengetahui tentang semua adaptor fisik yang ditautkan saat ini.

Untuk menunjukkan dukungan remapping DMA logis, driver juga harus mengisi DXGK_PHYSICAL_MEMORY_CAPS yang sesuai.

Untuk informasi selengkapnya, lihat remapping IOMMU DMA.