IOMMU_MAP_IDENTITY_RANGE_EX Rückruffunktion (wdm.h)
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) |