structure DXGK_IOMMU_CAPS (d3dkmddi.h)

Article
02/23/2024

La structure DXGK_IOMMU_CAPS est utilisée pour indiquer si un pilote prend en charge le remapping linéaire IOMMU.

Syntaxe

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

Membres

IommuIsolationSupported

Indique que le pilote prend en charge l’isolation IOMMU et utilise entièrement l’API de rappel IOMMU pour mapper les objets de mémoire alloués au pilote au domaine IOMMU. Ce champ imite DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeSupported. Dxgkrnl s’attend à ce que ces fonctionnalités correspondent.

IommuIsolationRequired

Indique que l’IOMMU est nécessaire pour que le matériel fonctionne correctement et en toute sécurité. Si un IOMMU n’est pas présent sur le système ou si un domaine ne peut pas être attaché à l’appareil, l’appareil ne démarre pas. Ce champ imite DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeRequired. Dxgkrnl s’attend à ce que ces fonctionnalités correspondent.

DmaRemappingSupported

Indique que le remapping linéaire est pris en charge par le pilote, et pas seulement par les mappages 1 :1 utilisés pour l’isolation standard. Si plusieurs cartes physiques liées ont des valeurs différentes pour leur adresse visible la plus élevée, le pilote doit signaler la valeur minimale de toutes les cartes physiques.

Reserved

Réservé ; ne pas utiliser.

Value

Une autre méthode pour accéder aux bits.

Remarques

Le pilote remplit cette structure lorsque Dxgkrnl appelle DxgkDdiQueryAdapterInfo avec une valeur DXGK_QUERYADAPTERINFOTYPE de DXGKQAITYPE_IOMMU_CAPS. Dxgkrnl appelle DxgkDdiQueryAdapterInfo une fois que DxgkddiAddDevice a été appelé pour toutes les cartes physiques, mais avant DxgkddiStartDevice. Le pilote est censé connaître toutes les cartes physiques liées à l’heure actuelle.

Pour indiquer la prise en charge du remapping DMA logique, le pilote doit également remplir DXGK_PHYSICAL_MEMORY_CAPS en conséquence.

Pour plus d’informations, consultez La réappinging iommu DMA.