IOMMU_DOMAIN_DETACH_DEVICE funzione di callback (wdm.h)

Articolo
02/27/2024

Scollega un dispositivo da un dominio esistente.

Sintassi

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

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

Parametri

[_In_] Domain

Puntatore all'handle al dominio.

[_In_] PhysicalDeviceObject

Puntatore all'oggetto dispositivo fisico (PDO) nello stack di dispositivi del dispositivo.

[_In_] InputMappingId

Mapping di input per il flusso desiderato del dispositivo.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituire un codice di errore NTSTATUS Value appropriato. Per altre informazioni, vedere Valori NTSTATUS.

Commenti

È responsabilità del driver assicurarsi che questa funzione non venga chiamata simultaneamente con IOMMU_DOMAIN_ATTACH_DEVICE o IOMMU_SET_DEVICE_FAULT_REPORTING chiamate nello stesso dispositivo.

InputMappingId viene usato solo per i dispositivi con enumerazione ACPI in ARM64. Per tutti gli altri casi, questo valore deve essere zero.

Se più dispositivi vengono collegati simultaneamente usando il valore MappingCount specificato nella chiamata IOMMU_DOMAIN_ATTACH_DEVICE, tali dispositivi possono essere scollegati solo come gruppo specificando un valore InputMappingId uguale al valore InputMappingIdBase di [IOMMU_DOMAIN_ATTACH_DEVICE] usato durante il collegamento.

Deprecato. È consigliabile usare IOMMU_DOMAIN_DETACH_DEVICE_EX e DMA_IOMMU_INTERFACE_EX.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1803
Intestazione	wdm.h (include Wdm.h)

Condividi tramite