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

  • Artigo

Desanexa um dispositivo de um domínio existente.

Sintaxe

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

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

Parâmetros

[_In_] Domain

Um ponteiro para o identificador para o domínio.

[_In_] PhysicalDeviceObject

Um ponteiro para o PDO (objeto de dispositivo físico) na pilha de dispositivos do dispositivo.

[_In_] InputMappingId

O mapeamento de entrada para o fluxo desejado do dispositivo.

Retornar valor

Retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS Values apropriado. Para obter mais informações, consulte Valores NTSTATUS.

Comentários

É responsabilidade do driver garantir que essa função não seja chamada simultaneamente com chamadas IOMMU_DOMAIN_ATTACH_DEVICE ou IOMMU_SET_DEVICE_FAULT_REPORTING no mesmo dispositivo.

InputMappingId é usado apenas para dispositivos enumerados por ACPI no ARM64. Para todos os outros casos, esse valor deve ser zero.

Se vários dispositivos forem anexados simultaneamente usando o valor MappingCount especificado na chamada IOMMU_DOMAIN_ATTACH_DEVICE , esses dispositivos só poderão ser desanexados como um grupo especificando um valor InputMappingId igual ao valor InputMappingIdBase de [IOMMU_DOMAIN_ATTACH_DEVICE] usado ao anexar.

Isso foi preterido. Considere usar IOMMU_DOMAIN_DETACH_DEVICE_EX e DMA_IOMMU_INTERFACE_EX.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho wdm.h (include Wdm.h)