IOMMU_MAP_IDENTITY_RANGE_EX Rückruffunktion (wdm.h)
Erstellt eine Identitätszuordnung für einen bereitgestellten physischen Adressraum in der angegebenen 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. Weitere Informationen zu den verfügbaren Berechtigungsbits finden Sie in den Hinweisen.
[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 Statuscodes.
| 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 seitenausgeglichen ist und eine Größe aufweist, 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 einen logischen Zuweisungsverteiler, der keine explizite logische Adresszuweisung zulässt. |
Bemerkungen
Verwenden Sie IOMMU_UNMAP_IDENTITY_RANGE_EX, um die Zuordnung der logischen Adresse aufzuheben, die von IOMMU_MAP_IDENTITY_RANGE_EXerstellt wurde.
Das Berechtigungsfeld ist ein Bitfeld, das die Zugriffsberechtigungen für die zuzuordnenden Seiten beschreibt.
Die Bits sind wie folgt definiert:
Bit 0 = Read Access
Bit 1 = Write Access
Bits 31-2 = Reserved (0)
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Server- | Windows Server 2022 |
| Header- | wdm.h (include Wdm.h) |