IOMMU_DOMAIN_ATTACH_DEVICE_EX Rückruffunktion (wdm.h)

2025-02-07

Fügt eine IOMMU_DMA_DEVICE an eine vorhandene DMA-Gerätedomäne an.

Syntax

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

Parameter

Domain

[In] Ein Handle für die Domäne, an die die IOMMU_DMA_DEVICE angefügt wird.

DmaDevice

[In] Ein Zeiger auf die IOMMU_DMA_DEVICE, die angefügt werden soll.

Rückgabewert

STATUS_SUCCESS, wenn der Vorgang erfolgreich ist. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Die Routine konnte erforderliche Ressourcen nicht zuordnen.
STATUS_INVALID_PARAMETER	Das Gerät ist bereits an eine Domäne angefügt.
STATUS_ACCESS_DENIED	Das Gerät darf derzeit nicht an diesen Domänentyp angefügt werden.

Weitere Informationen finden Sie unter NTSTATUS Values.

Bemerkungen

Der Aufrufer ist dafür verantwortlich, sicherzustellen, dass die IOMMU_DMA_DEVICE zuerst durch IOMMU_DOMAIN_DETACH_DEVICE_EXvon einer zuvor angefügten Domäne getrennt wird, bevor Sie versuchen, sie an eine andere Domäne anzufügen.

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

Wenn STATUS_ACCESS_DENIED zurückgegeben wird, ist der Domänentyp wahrscheinlich nicht verfügbar, an das das Gerät angeschlossen werden soll. Es wird empfohlen, IOMMU_DEVICE_QUERY_DOMAIN_TYPES zu verwenden, um zu bestimmen, welche Domänentypen für das angegebene Gerät verfügbar sind. Die verfügbaren Typen können je nach DMA Guard-Richtlinie und den Gerätemerkmalen variieren. Wenn Sie benachrichtigt werden möchten, wann Domänentypen verfügbar sind, sollten Sie IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK verwenden, um einen Benachrichtigungsrückruf zu registrieren, wenn sich die verfügbaren Domänentypen ändern.