IOMMU_MAP_IDENTITY_RANGE_EX Rückruffunktion (wdm.h)

  • Artikel

Erstellt eine Identitätszuordnung für einen bereitgestellten physischen Adressraum in der bereitgestellten Domäne.

Syntax

IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;

NTSTATUS IommuMapIdentityRangeEx(
  [in] PIOMMU_DMA_DOMAIN Domain,
  [in] ULONG Permissions,
  [in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}

Parameter

[in] Domain

Ein Zeiger auf die IOMMU_DMA_DOMAIN , zu der die zugeordnete physische Identitätsadresse gehört. Die Domäne muss vom Typ DomainTypeTranslate oder DomainTypePassThrough sein. Weitere Informationen zu Domänentypen finden Sie unter IOMMU_DMA_DOMAIN_TYPE.

[in] Permissions

Ein Bitfeld, das die Berechtigungen darstellt, die für den zugeordneten Bereich festgelegt werden sollen. Informationen zu den verfügbaren Berechtigungsbits finden Sie unter Hinweise.

[in] PhysicalAddressToMap

Die IOMMU_MAP_PHYSICAL_ADDRESS , die der Domäne zugeordnet wird.

Rückgabewert

STATUS_SUCCESS , wenn der Vorgang erfolgreich ist. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER_1 Die bereitgestellte Domäne ist nicht vom Typ DomainTypeTranslate oder DomainTypePassThrough.
STATUS_INVALID_PARAMETER_3 Die bereitgestellte IOMMU_MAP_PHYSICAL_ADDRESS stellt keinen physischen Speicher dar, der seitenbündig ausgerichtet ist und eine Größe hat, die ein Vielfaches von PAGE_SIZE ist.
STATUS_IN_USE Der Identitätsbereich ist bereits zugeordnet oder teilweise zugeordnet.
STATUS_NOT_SUPPORTED Die bereitgestellte Domäne enthält eine logische Zuweisung, die keine explizite logische Adresszuordnung zulässt.

Hinweise

Verwenden Sie IOMMU_UNMAP_IDENTITY_RANGE_EX, um die Zuordnung der von IOMMU_MAP_IDENTITY_RANGE_EX erstellten logischen Adresse aufzuheben.

Das Berechtigungsfeld ist ein Bitfeld, das die Zugriffsberechtigungen für die zu zuordnenden Seiten beschreibt.

Die Bits werden wie folgt definiert:

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Server) Windows Server 2022
Kopfzeile wdm.h (wdm.h einschließen)

Weitere Informationen

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS