Compartir a través de

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

  • Artículo

Desasocia un dispositivo de un dominio existente.

Sintaxis

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

NTSTATUS IommuDomainDetachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingId
)
{...}

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_] InputMappingId

Asignación de entrada para la secuencia deseada del dispositivo.

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 esta función no se llama simultáneamente con IOMMU_DOMAIN_ATTACH_DEVICE o IOMMU_SET_DEVICE_FAULT_REPORTING llamadas en el mismo dispositivo.

InputMappingId solo se usa para dispositivos enumerados por ACPI en ARM64. Para todos los demás casos, este valor debe ser cero.

Si varios dispositivos se asocian simultáneamente mediante el valor MappingCount especificado en la llamada IOMMU_DOMAIN_ATTACH_DEVICE, esos dispositivos solo se pueden desasociar como un grupo especificando un valor InputMappingId igual al valor InputMappingIdBase de [IOMMU_DOMAIN_ATTACH_DEVICE] que se usa al adjuntar.

Esto está en desuso. Considere la posibilidad de usar IOMMU_DOMAIN_DETACH_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)