функция обратного вызова 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) |