IOMMU_DOMAIN_ATTACH_DEVICE Rückruffunktion (wdm.h)

Artikel
02/07/2025

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 des physischen Geräteobjekts (PDO) im Gerätestapel des Geräts.

[_In_] InputMappingIdBase

Die Eingabezuordnungsbasis für den gewünschten Datenstrom 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. Geben Sie andernfalls einen entsprechenden NTSTATUS-Wertefehlercode zurück. Weitere Informationen finden Sie unter NTSTATUS Values.

Bemerkungen

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-aufgezählte Geräte vorgesehen, die mehrere Stream-IDs auf ARM64 unterstützen. Für jedes andere Gerät oder jede andere Architektur müssen die folgenden Werte verwendet werden:

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
mindestens unterstützte Client-	Windows 10, Version 1803
Header-	wdm.h (include Wdm.h)

Freigeben über