IOMMU_DOMAIN_ATTACH_DEVICE Rückruffunktion (wdm.h)

  • Artikel

Fügt ein Gerät an eine vorhandene Domäne an.

Syntax

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

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

Parameter

[_In_] Domain

Ein Zeiger auf das Handle auf die Domäne.

[_In_] PhysicalDeviceObject

Ein Zeiger auf das physische Geräteobjekt (PDO) im Gerätestapel des Geräts.

[_In_] InputMappingIdBase

Die Eingabezuordnungsbasis für den gewünschten Stream des Geräts.

[_In_] MappingCount

Die Anzahl der Zuordnungen, die an der Basis beginnen.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls geben Sie einen entsprechenden FEHLERCODE für NTSTATUS-Werte zurück. Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Es liegt in der Verantwortung des Treibers sicherzustellen, dass diese Funktion nicht gleichzeitig mit IOMMU_DOMAIN_DETACH_DEVICE oder IOMMU_SET_DEVICE_FAULT_REPORTING Aufrufen auf demselben Gerät aufgerufen wird.

InputMappingIdBase und MappingCount sind nur für ACPI-enumerierte Geräte vorgesehen, die mehrere Stream-IDs auf ARM64 unterstützen. Für jedes andere Gerät oder jede andere Architektur müssen diese Werte wie folgt sein:

  • InputMappingIdBase = 0

  • MappingCount = 1

Dies ist veraltet. Erwägen Sie die Verwendung von IOMMU_DOMAIN_ATTACH_DEVICE_EX und DMA_IOMMU_INTERFACE_EX.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1803
Kopfzeile wdm.h (einschließen von Wdm.h)