IOMMU_DOMAIN_ATTACH_DEVICE_EX Rückruffunktion (wdm.h)

Artikel
02/29/2024

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 der 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 status Codes.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Die Routine konnte die erforderlichen 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-Werte.

Hinweise

Der Aufrufer ist dafür verantwortlich, sicherzustellen, dass die IOMMU_DMA_DEVICE zuerst mithilfe von IOMMU_DOMAIN_DETACH_DEVICE_EX von einer zuvor angefügten Domäne getrennt wird, bevor versucht wird, 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 es wahrscheinlich, dass der Domänentyp derzeit nicht für das Gerät verfügbar ist, an das angefügt werden kann. 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 abhängig von der DMA Guard-Richtlinie und den Gerätemerkmalen variieren. Um benachrichtigt zu werden, wenn 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.