функция обратного вызова IOMMU_DOMAIN_CREATE_EX (wdm.h)
Создает новый домен устройства DMA на основе предоставленного типа домена.
Синтаксис
IOMMU_DOMAIN_CREATE_EX IommuDomainCreateEx;
NTSTATUS IommuDomainCreateEx(
[in] IOMMU_DMA_DOMAIN_TYPE DomainType,
[in] IOMMU_DMA_DOMAIN_CREATION_FLAGS Flags,
[in, optional] PIOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG LogicalAllocatorConfig,
[in, optional] PIOMMU_DMA_RESERVED_REGION ReservedRegions,
[out] PIOMMU_DMA_DOMAIN *DomainOut
)
{...}
Параметры
[in] DomainType
Указывает тип создаваемого домена. См. IOMMU_DMA_DOMAIN_TYPE.
[in] Flags
Флаги конфигурации для домена устройства. В настоящее время неиспользуемый и должен иметь значение 0. См. IOMMU_DMA_DOMAIN_CREATION_FLAGS.
[in, optional] LogicalAllocatorConfig
При необходимости предоставляет конфигурацию логического распределителя для инициализации логического распределителя HAL, связанного с доменом. См. IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.
[in, optional] ReservedRegions
При необходимости предоставляет набор структур IOMMU_DMA_RESERVED_REGION, зарезервированных во время создания домена.
[out] DomainOut
Возвращает непрозрачный дескриптор для созданного домена.
Возвращаемое значение
STATUS_SUCCESS, если операция выполнена успешно. Возможные значения возвращаемых ошибок включают следующие коды состояния.
| Возвращаемый код | Описание |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | Подпрограмма не удалось выделить ресурсы, необходимые для домена, или для неуправляемых доменов недостаточно идентификаторов ASID. |
| STATUS_NOT_SUPPORTED | Интерфейс домена гипервизора недоступен, гостевой компьютер x86 пытается создать домен или указанный тип домена в настоящее время не разрешен. |
Дополнительные сведения см. в значения NTSTATUS.
Замечания
Чтобы удалить домен, созданный IOMMU_DOMAIN_CREATE_EX, используйте IOMMU_DOMAIN_DELETE; В настоящее время нет эквивалента удаления домена.
Требования
| Требование | Ценность |
|---|---|
| минимальный поддерживаемый сервер | Windows Server 2022 |
| заголовка | wdm.h (include Wdm.h) |
См. также
IOMMU_DMA_DOMAIN_CREATION_FLAGS