IOMMU_DOMAIN_ATTACH_DEVICE función de devolución de llamada (wdm.h)
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 apropiado. Para obtener más información, vea valores NTSTATUS.
Observaciones
Es responsabilidad del controlador asegurarse de que esta función no se llama 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 flujo 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 | Valor |
---|---|
cliente mínimo admitido | Windows 10, versión 1803 |
encabezado de | wdm.h (incluya Wdm.h) |