IOMMU_DOMAIN_ATTACH_DEVICE funzione di callback (wdm.h)

Articolo
02/27/2024

Collega un dispositivo a un dominio esistente.

Sintassi

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

Parametri

[_In_] Domain

Puntatore all'handle al dominio.

[_In_] PhysicalDeviceObject

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

[_In_] InputMappingIdBase

Base di mapping di input per il flusso desiderato del dispositivo.

[_In_] MappingCount

Conteggio dei mapping a partire dalla base.

Valore restituito

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

Commenti

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

InputMappingIdBase e MappingCount sono destinati solo ai dispositivi acpi enumerati che supportano più ID di flusso in ARM64. Per qualsiasi altro dispositivo o architettura, questi valori devono essere:

InputMappingIdBase = 0
MappingCount = 1

Deprecato. È consigliabile usare IOMMU_DOMAIN_ATTACH_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