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

Artículo
02/27/2024

Asocia un IOMMU_DMA_DEVICE a un dominio de dispositivo DMA existente.

Sintaxis

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

Parámetros

Domain

[In] Identificador del dominio al que se asociará el IOMMU_DMA_DEVICE .

DmaDevice

[In] Puntero al IOMMU_DMA_DEVICE que se va a adjuntar.

Valor devuelto

STATUS_SUCCESS si la operación se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	La rutina no pudo asignar los recursos necesarios.
STATUS_INVALID_PARAMETER	El dispositivo ya está conectado a un dominio.
STATUS_ACCESS_DENIED	El dispositivo no puede asociarse actualmente a este tipo de dominio.

Para obtener más información, vea Valores NTSTATUS.

Comentarios

El autor de la llamada es responsable de asegurarse de que el IOMMU_DMA_DEVICE se desasocie primero, mediante IOMMU_DOMAIN_DETACH_DEVICE_EX, de cualquier dominio adjunto previamente antes de intentar adjuntarlo a otro dominio.

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

Si STATUS_ACCESS_DENIED se devuelve, es probable que el tipo de dominio no esté disponible actualmente para que el dispositivo se conecte. Se recomienda usar IOMMU_DEVICE_QUERY_DOMAIN_TYPES para determinar qué tipos de dominio están disponibles para el dispositivo especificado. Los tipos disponibles pueden variar según la directiva DMA Guard y las características del dispositivo. Para recibir una notificación de cuándo están disponibles los tipos de dominio, considere la posibilidad de usar IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK para registrar una devolución de llamada de notificación cada vez que cambien los tipos de dominio disponibles.