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

Статья
02/29/2024

Создает новый домен устройства 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 пытается создать домен или указанный тип домена в настоящее время не разрешен.