IOMMU_MAP_IDENTITY_RANGE_EX función de devolución de llamada (wdm.h)

  • Artículo

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)

Consulte también

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS