IOMMU_MAP_IDENTITY_RANGE_EX fonction de rappel (wdm.h)
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) |