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

IOMMU_MAP_PHYSICAL_ADDRESS

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT