IOMMU_MAP_IDENTITY_RANGE_EX fonction de rappel (wdm.h)

Article
03/05/2024

Crée un mappage d’identité pour un espace d’adressage physique fourni dans le domaine fourni.

Syntaxe

IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;

NTSTATUS IommuMapIdentityRangeEx(
  [in] PIOMMU_DMA_DOMAIN Domain,
  [in] ULONG Permissions,
  [in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}

Paramètres

[in] Domain

Pointeur vers le IOMMU_DMA_DOMAIN auquel l’adresse physique mappée d’identité appartiendra. Le domaine doit être de type DomainTypeTranslate ou DomainTypePassThrough. Pour plus d’informations sur les types de domaine, consultez IOMMU_DMA_DOMAIN_TYPE.

[in] Permissions

Champ de bits représentant les autorisations à définir pour la plage en cours de mappage. Consultez Remarques pour connaître les bits d’autorisation disponibles.

[in] PhysicalAddressToMap

Le IOMMU_MAP_PHYSICAL_ADDRESS qui sera mappé au domaine.

Valeur retournée

STATUS_SUCCESS si l’opération réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Code de retour	Description
STATUS_INVALID_PARAMETER_1	Le domaine fourni n’est pas de type DomainTypeTranslate ou DomainTypePassThrough.
STATUS_INVALID_PARAMETER_3	Le IOMMU_MAP_PHYSICAL_ADDRESS fourni ne représente pas la mémoire physique alignée sur la page et dont la taille est un multiple de PAGE_SIZE.
STATUS_IN_USE	La plage d’identités est déjà mappée ou partiellement mappée.
STATUS_NOT_SUPPORTED	Le domaine fourni contient un allocateur logique qui n’autorise pas l’allocation d’adresses logiques explicites.

Remarques

Pour annuler le mappage de l’adresse logique créée par IOMMU_MAP_IDENTITY_RANGE_EX, utilisez IOMMU_UNMAP_IDENTITY_RANGE_EX.

Le champ autorisations est un champ de bits qui décrit les autorisations d’accès pour les pages à mapper.

Les bits sont définis comme suit :

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)

Configuration requise

Condition requise	Valeur
Serveur minimal pris en charge	Windows Server 2022
En-tête	wdm.h (inclure Wdm.h)

Voir aussi

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS

Partager via