IOMMU_MAP_RESERVED_LOGICAL_RANGE Rückruffunktion (wdm.h)
Ordnet einen reservierten logischen Bereich zu.
Im Gegensatz zu IOMMU_MAP_LOGICAL_RANGE_EXist dies garantiert, dass keine Speicherzuordnungen ausgeführt werden, da sie bereits zuvor mit IOMMU_RESERVE_LOGICAL_ADDRESS_RANGEdurchgefü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
Die IOMMU_DMA_LOGICAL_ADDRESS_TOKEN, der 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. 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.
[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 sind die folgenden Statuscodes.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER_2 | Der bereitgestellte Offset ist nicht seitenbündig ausgerichtet. |
| STATUS_INVALID_PARAMETER_4 | Die angegebene physische Adresse ist nicht auf der Seite ausgerichtet und/oder ist keine ganze Anzahl von Seiten in der Größe. |
| STATUS_RESOURCE_IN_USE | Der im logischen Adresstoken dargestellte logische Adressbereich ist bereits vollständig oder teilweise zugeordnet. |
| STATUS_UNSUCCESSFUL | Das logische Adresstoken wird zurzeit gelöscht. |
Weitere Informationen finden Sie unter NTSTATUS Values.
Bemerkungen
Ein zugeordnetes logisches Adresstoken kann über IOMMU_UNMAP_RESERVED_LOGICAL_RANGEnicht zugeordnet werden.
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) |
Siehe auch
IOMMU_UNMAP_RESERVED_LOGICAL_RANGE