функция обратного вызова IOMMU_MAP_IDENTITY_RANGE_EX (wdm.h)

Создает сопоставление удостоверений для предоставленного физического адресного пространства в указанном домене.

Синтаксис

IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;

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

Параметры

[in] Domain

Указатель на IOMMU_DMA_DOMAIN , которому будет принадлежать сопоставленный физический адрес удостоверения. Домен должен иметь тип DomainTypeTranslate или DomainTypePassThrough. Дополнительные сведения о типах доменов см. в разделе IOMMU_DMA_DOMAIN_TYPE.

[in] Permissions

Битовое поле, представляющее разрешения, которые необходимо задать для сопоставляемого диапазона. Доступные биты разрешений см. в разделе Примечания.

[in] PhysicalAddressToMap

IOMMU_MAP_PHYSICAL_ADDRESS, которая будет сопоставлена с доменом.

Возвращаемое значение

STATUS_SUCCESS , если операция выполнена успешно. Возможные возвращаемые значения ошибок включают следующие коды состояния.

Код возврата Описание
STATUS_INVALID_PARAMETER_1 Указанный домен не имеет типа DomainTypeTranslate или DomainTypePassThrough.
STATUS_INVALID_PARAMETER_3 Предоставленный IOMMU_MAP_PHYSICAL_ADDRESS не представляет физическую память, выровненную по страницам, и имеет размер, кратный PAGE_SIZE.
STATUS_IN_USE Диапазон удостоверений уже сопоставлен или частично сопоставлен.
STATUS_NOT_SUPPORTED Указанный домен содержит логический распределител, который не допускает явного выделения логических адресов.

Комментарии

Чтобы отменить сопоставление логического адреса, созданного IOMMU_MAP_IDENTITY_RANGE_EX, используйте IOMMU_UNMAP_IDENTITY_RANGE_EX.

Поле разрешений — это битовое поле, описывающее разрешения на доступ к сопоставляемой странице.

Биты определяются следующим образом:

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)

Требования

Требование Значение
Минимальная версия сервера Windows Server 2022
Верхняя часть wdm.h (включая Wdm.h)

См. также раздел

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS