IOMMU_DEVICE_QUERY_DOMAIN_TYPES Rückruffunktion (wdm.h)

Artikel
02/29/2024

Fragt die verfügbaren Domänentypen ab, an die ein IOMMU_DMA_DEVICE je nach Umgebungsfaktoren wie Plattform und DMA-Guard-Richtlinie anfügen darf.

Syntax

IOMMU_DEVICE_QUERY_DOMAIN_TYPES IommuDeviceQueryDomainTypes;

void IommuDeviceQueryDomainTypes(
  PIOMMU_DMA_DEVICE DmaDevice,
  PULONG AvailableDomains
)
{...}

Parameter

DmaDevice

[In] Ein Zeiger auf ein undurchsichtiges Token, das die IOMMU_DMA_DEVICE darstellt.

AvailableDomains

[Out] Gibt die aktuellen Domänentypen zurück, die erstellt und angefügt werden können. Jedes festgelegte Bit stellt einen verfügbaren Domänentyp dar: (1 << IOMMU_DMA_DOMAIN_TYPE). Siehe IOMMU_DMA_DOMAIN_TYPE.

Rückgabewert

Keine

Bemerkungen

Dies kann als Hinweis verwendet werden, ob IOMMU_DOMAIN_ATTACH_DEVICE_EX erfolgreich ist.

Wenn sich ein Gerät nicht hinter einer DMA-Remapping-kompatiblen IOMMU befindet, ist keine Neuzuordnungsdomäne verfügbar.

Wenn DMA Guard aktiviert ist, können Passthroughdomänen basierend auf der Richtlinie verfügbar sein, d.h. ob das Gerät für die DMA-Neuzuordnung aktiviert ist, extern verbunden ist, der Bildschirmsperrstatus usw. Wenn die DMA Guard-Blockierung aktiv ist, sind Passthroughdomänen nicht verfügbar und AvailableDomains & (1 << DomainTypePassThrough) führen zu 0.

Um benachrichtigt zu werden, wenn Domänentypen verfügbar sind, sollten Sie IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK verwenden, um einen Benachrichtigungsrückruf zu registrieren, wenn sich die verfügbaren Domänentypen ändern.