Compartilhar via

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

  • Artigo

Anexa um dispositivo a um domínio existente.

Sintaxe

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

Parâmetros

[_In_] Domain

Um ponteiro para o identificador para o domínio.

[_In_] PhysicalDeviceObject

Um ponteiro para o PDO (objeto de dispositivo físico) na pilha de dispositivos do dispositivo.

[_In_] InputMappingIdBase

A base de mapeamento de entrada para o fluxo desejado do dispositivo.

[_In_] MappingCount

A contagem de mapeamentos que começam na base.

Retornar valor

Retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro de valores NTSTATUS apropriado. Para obter mais informações, consulte Valores NTSTATUS.

Comentários

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

InputMappingIdBase e MappingCount destinam-se apenas a acomodar dispositivos enumerados por ACPI que dão suporte a várias IDs de fluxo no ARM64. Para qualquer outro dispositivo ou arquitetura, esses valores devem ser:

  • InputMappingIdBase = 0

  • MappingCount = 1

Isso foi preterido. Considere usar IOMMU_DOMAIN_ATTACH_DEVICE_EX e DMA_IOMMU_INTERFACE_EX.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho wdm.h (include Wdm.h)