IOMMU_MAP_IDENTITY_RANGE_EX función de devolución de llamada (wdm.h)
Crea una asignación de identidad para un espacio de direcciones físico proporcionado en el dominio proporcionado.
Sintaxis
IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;
NTSTATUS IommuMapIdentityRangeEx(
[in] PIOMMU_DMA_DOMAIN Domain,
[in] ULONG Permissions,
[in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}
Parámetros
[in] Domain
Puntero a la IOMMU_DMA_DOMAIN a la que pertenecerá la dirección física asignada por la identidad. El dominio debe ser de tipo DomainTypeTranslate o DomainTypePassThrough. Para obtener más información sobre los tipos de dominio, consulte IOMMU_DMA_DOMAIN_TYPE.
[in] Permissions
Campo de bits que representa los permisos que se van a establecer para el intervalo que se va a asignar. Vea Comentarios para los bits de permiso disponibles.
[in] PhysicalAddressToMap
El IOMMU_MAP_PHYSICAL_ADDRESS que se asignará al dominio.
Valor devuelto
STATUS_SUCCESS si la operación se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER_1 | El dominio proporcionado no es de tipo DomainTypeTranslate ni DomainTypePassThrough. |
| STATUS_INVALID_PARAMETER_3 | El IOMMU_MAP_PHYSICAL_ADDRESS proporcionado no representa la memoria física alineada con páginas y tiene un tamaño que es un múltiplo de PAGE_SIZE. |
| STATUS_IN_USE | El intervalo de identidades ya está asignado o parcialmente asignado. |
| STATUS_NOT_SUPPORTED | El dominio proporcionado contiene un asignador lógico que no permite la asignación explícita de direcciones lógicas. |
Comentarios
Para desasignación de la dirección lógica creada por IOMMU_MAP_IDENTITY_RANGE_EX, use IOMMU_UNMAP_IDENTITY_RANGE_EX.
El campo de permisos es un campo de bits que describe los permisos de acceso para las páginas que se van a asignar.
Los bits se definen de la siguiente manera:
Bit 0 = Read Access
Bit 1 = Write Access
Bits 31-2 = Reserved (0)
Requisitos
| Requisito | Value |
|---|---|
| Servidor mínimo compatible | Windows Server 2022 |
| Encabezado | wdm.h (incluya Wdm.h) |