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