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

Artigo
02/07/2025

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 do 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 começando na base.

Valor de retorno

Retorne 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.

Observações

É 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
de cliente com suporte mínimo	Windows 10, versão 1803
cabeçalho	wdm.h (inclua Wdm.h)

Compartilhar via