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

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

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

DmaDevice

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

Valor de retorno

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

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

Observações

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 IOMMU_SET_DEVICE_FAULT_REPORTING_EX chamadas 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 sobre 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.

Requisitos

Consulte também

IOMMU_DOMAIN_DETACH_DEVICE_EX

IOMMU_SET_DEVICE_FAULT_REPORTING_EX

IOMMU_DEVICE_QUERY_DOMAIN_TYPES

IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX