IOMMU_MAP_RESERVED_LOGICAL_RANGE Rückruffunktion (wdm.h)
Ordnet einen reservierten logischen Bereich zu.
Im Gegensatz zu IOMMU_MAP_LOGICAL_RANGE_EX wird dadurch garantiert, dass keine Speicherzuordnungen ausgeführt werden, da davon ausgegangen wird, dass sie bereits zuvor mit IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE ausgeführt wurden.
Syntax
IOMMU_MAP_RESERVED_LOGICAL_RANGE IommuMapReservedLogicalRange;
NTSTATUS IommuMapReservedLogicalRange(
[in, out] PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN LogicalAddressToken,
[in] SIZE_T Offset,
[in] ULONG Permissions,
[in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap,
[out] PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT MappedSegment
)
{...}
Parameter
[in, out] LogicalAddressToken
Der IOMMU_DMA_LOGICAL_ADDRESS_TOKEN , dem zugeordnet werden soll.
[in] Offset
Der Offset in Bytes in das logische Adresstoken, das die zuzuordnende logische Basisadresse darstellt.
[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.
[out] MappedSegment
Gibt die IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT zurück, die ein Segment des logischen Adresstokens darstellt, das jetzt zugeordnet ist.
Rückgabewert
STATUS_SUCCESS , wenn der Vorgang erfolgreich ist. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER_2 | Der angegebene Offset ist nicht seitenbündig. |
| STATUS_INVALID_PARAMETER_4 | Die angegebene physische Adresse ist nicht seitenbündig und/oder ist keine ganze Anzahl von Seiten groß. |
| STATUS_RESOURCE_IN_USE | Der im logischen Adresstoken dargestellte logische Adressbereich ist bereits vollständig oder teilweise zugeordnet. |
| STATUS_UNSUCCESSFUL | Das logische Adresstoken wird derzeit gelöscht. |
Weitere Informationen finden Sie unter NTSTATUS-Werte.
Hinweise
Ein zugeordnetes Segment mit logischem Adresstoken kann über IOMMU_UNMAP_RESERVED_LOGICAL_RANGE aufgehoben werden.
Das Berechtigungsfeld ist ein Bitfeld, das die Zugriffsberechtigungen für die zuzuordnenden 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 (einschließen von Wdm.h) |
Weitere Informationen
IOMMU_UNMAP_RESERVED_LOGICAL_RANGE