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

Статья
02/07/2025

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

Синтаксис

IOMMU_MAP_LOGICAL_RANGE_EX IommuMapLogicalRangeEx;

NTSTATUS IommuMapLogicalRangeEx(
  [in]           PIOMMU_DMA_DOMAIN Domain,
  [in]           ULONG Permissions,
  [in]           PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS ExplicitLogicalAddress,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS MinLogicalAddress,
  [in, optional] PIOMMU_DMA_LOGICAL_ADDRESS MaxLogicalAddress,
  [out]          PIOMMU_DMA_LOGICAL_ADDRESS LogicalAddressOut
)
{...}

Параметры

[in] Domain

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

[in] Permissions

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

[in] PhysicalAddressToMap

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

[in, optional] ExplicitLogicalAddress

Логический адрес домена, с которым должен быть сопоставлен физический адрес. Если домен не был создан с зарегистрированным логическим распределителем, это поле необходимо. Если домен был создан с зарегистрированным логическим распределителем, который не поддерживает явное выделение логических адресов, это поле должно быть null.

[in, optional] MinLogicalAddress

Минимальный (включительно) допустимый логический адрес, с которым должен сопоставляться физический адрес. Если домен не был создан с зарегистрированным логическим распределителем, это поле будет игнорироваться.

[in, optional] MaxLogicalAddress

Максимальный (включительно) допустимый логический адрес, с которым должен сопоставляться физический адрес. Если домен не был создан с зарегистрированным логическим распределителем, это поле будет игнорироваться.

[out] LogicalAddressOut

Возвращает полученный логический адрес из сопоставления.

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

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

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER_1	Указанный домен не имеет типа DomainTypeTranslate.
STATUS_INVALID_PARAMETER_3	Предоставленный IOMMU_MAP_PHYSICAL_ADDRESS не представляет физической памяти, выровненной по страницам, и имеет размер, который является несколькими PAGE_SIZE.
STATUS_INVALID_PARAMETER_4	Предоставленный параметр ExplicitLogicalAddress не выровнен по страницам.
STATUS_INVALID_PARAMETER_MIX	Не удалось выполнить указанные минимальные и максимальные логические адреса.
STATUS_IN_USE	Объект ExplicitLogicalAddress уже сопоставлен или частично сопоставлен.
STATUS_NOT_SUPPORTED	Объект ExplicitLogicalAddress был предоставлен для домена с логическим распределителем, который не разрешает явное выделение логических адресов. Или для домена без логического распределителя не было предоставлено значение ExplicitLogicalAddress.

Дополнительные сведения см. в значения NTSTATUS.

Замечания

Чтобы отменить сопоставление логического адреса, созданного IOMMU_MAP_LOGICAL_RANGE_EX, используйте IOMMU_UNMAP_LOGICAL_RANGE; В настоящее время нет эквивалента Ex для распаки диапазона логических адресов.

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

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

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)