IOMMU_DOMAIN_ATTACH_DEVICE función de devolución de llamada (wdm.h)

  • Artículo

Asocia un dispositivo a un dominio existente.

Sintaxis

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

Puntero al identificador del dominio.

[_In_] PhysicalDeviceObject

Puntero al objeto de dispositivo físico (PDO) en la pila de dispositivos del dispositivo.

[_In_] InputMappingIdBase

Base de asignación de entrada para la secuencia deseada del dispositivo.

[_In_] MappingCount

Recuento de asignaciones que comienzan en la base.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error de valores NTSTATUS adecuado. Para obtener más información, vea Valores NTSTATUS.

Comentarios

Es responsabilidad del controlador asegurarse de que no se llama a esta función simultáneamente con IOMMU_DOMAIN_DETACH_DEVICE o IOMMU_SET_DEVICE_FAULT_REPORTING llamadas en el mismo dispositivo.

InputMappingIdBase y MappingCount solo están diseñados para dar cabida a dispositivos enumerados por ACPI que admiten varios identificadores de secuencia en ARM64. Para cualquier otro dispositivo o arquitectura, estos valores deben ser:

  • InputMappingIdBase = 0

  • MappingCount = 1

Esto está en desuso. Considere la posibilidad de usar IOMMU_DOMAIN_ATTACH_DEVICE_EX y DMA_IOMMU_INTERFACE_EX.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1803
Encabezado wdm.h (incluya Wdm.h)