IOMMU_DOMAIN_ATTACH_DEVICE_EX função de retorno de chamada (wdm.h)

Artigo
02/29/2024

Anexa um IOMMU_DMA_DEVICE a um domínio de dispositivo DMA existente.

Sintaxe

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

Parâmetros

Domain

[In] Um identificador para o domínio ao qual o IOMMU_DMA_DEVICE será anexado.

DmaDevice

[In] Um ponteiro para o IOMMU_DMA_DEVICE a ser anexado.

Retornar valor

STATUS_SUCCESS se a operação for bem-sucedida. Os possíveis valores retornados por erro incluem os seguintes códigos de status.

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	A rotina falhou ao alocar os recursos necessários.
STATUS_INVALID_PARAMETER	O dispositivo já está anexado a um domínio.
STATUS_ACCESS_DENIED	No momento, o dispositivo não tem permissão para anexar a esse tipo de domínio.

Para obter mais informações, consulte Valores NTSTATUS.

Comentários

O chamador é responsável por garantir que o IOMMU_DMA_DEVICE seja desanexado primeiro, usando IOMMU_DOMAIN_DETACH_DEVICE_EX, de qualquer domínio anexado anteriormente antes de tentar anexá-lo a outro domínio.

É responsabilidade do driver garantir que essa função não seja chamada simultaneamente com qualquer IOMMU_DOMAIN_DETACH_DEVICE_EX ou chamadas IOMMU_SET_DEVICE_FAULT_REPORTING_EX no mesmo dispositivo.

Se STATUS_ACCESS_DENIED for retornado, é provável que o tipo de domínio não esteja disponível no momento para o dispositivo ser anexado. É recomendável utilizar IOMMU_DEVICE_QUERY_DOMAIN_TYPES para determinar quais tipos de domínio estão disponíveis para o dispositivo especificado. Os tipos disponíveis podem variar dependendo da política do DMA Guard e das características do dispositivo. Para ser notificado de quando os tipos de domínio estão disponíveis, considere usar IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK para registrar um retorno de chamada de notificação sempre que os tipos de domínio disponíveis forem alterados.