DXGK_IOMMU_CAPS Struktur (d3dkmddi.h)

Artikel
02/23/2024

Die DXGK_IOMMU_CAPS-Struktur wird verwendet, um anzugeben, ob ein Treiber die lineare IOMMU-Neuzuordnung unterstützt.

Syntax

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

Member

IommuIsolationSupported

Gibt an, dass der Treiber die IOMMU-Isolation unterstützt und die IOMMU-Rückruf-API vollständig nutzt, um treiberseitig zugewiesene Speicherobjekte der IOMMU-Domäne zuzuordnen. Dieses Feld imitiert DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeSupported. Dxgkrnl erwartet, dass diese Funktionen übereinstimmen.

IommuIsolationRequired

Gibt an, dass die IOMMU erforderlich ist, damit die Hardware ordnungsgemäß und sicher funktioniert. Wenn auf dem System keine IOMMU vorhanden ist oder keine Domäne an das Gerät angefügt werden kann, wird das Gerät nicht gestartet. Dieses Feld imitiert DXGK_DRIVERCAPS. MemoryManagementCaps.IOMMUSecureModeRequired. Dxgkrnl erwartet, dass diese Funktionen übereinstimmen.

DmaRemappingSupported

Gibt an, dass die lineare Neuzuordnung vom Treiber unterstützt wird und nicht nur die 1:1-Zuordnungen, die für die Standardisolation verwendet werden. Wenn mehrere verknüpfte physische Adapter unterschiedliche Werte für die höchste sichtbare Adresse aufweisen, sollte der Treiber den Mindestwert aller physischen Adapter melden.

Reserved

Reserviert; nicht verwenden.

Value

Eine alternative Methode für den Zugriff auf die Bits.

Hinweise

Der Treiber füllt diese Struktur aus, wenn DxgkrnlDxgkDdiQueryAdapterInfo mit dem DXGK_QUERYADAPTERINFOTYPE Wert DXGKQAITYPE_IOMMU_CAPS aufruft. Dxgkrnl ruft DxgkDdiQueryAdapterInfo auf, nachdem DxgkddiAddDevice für alle physischen Adapter aufgerufen wurde, aber vor DxgkddiStartDevice. Es wird erwartet, dass der Treiber zu diesem Zeitpunkt über alle verknüpften physischen Adapter bescheid weiß.

Um die Unterstützung logischer DMA-Neuzuordnungen anzugeben, muss der Treiber auch DXGK_PHYSICAL_MEMORY_CAPS entsprechend ausfüllen.

Weitere Informationen finden Sie unter IOMMU DMA Remapping.