IOMMU_DOMAIN_DETACH_DEVICE Rückruffunktion (wdm.h)

Artikel
02/27/2024

Trennt ein Gerät von einer vorhandenen Domäne.

Syntax

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

NTSTATUS IommuDomainDetachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingId
)
{...}

Parameter

[_In_] Domain

Ein Zeiger auf das Handle auf die Domäne.

[_In_] PhysicalDeviceObject

Ein Zeiger auf das objekt des physischen Geräts (PDO) im Gerätestapel des Geräts.

[_In_] InputMappingId

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

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS-Werte-Fehlercode 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_ATTACH_DEVICE- oder IOMMU_SET_DEVICE_FAULT_REPORTING Aufrufen auf demselben Gerät aufgerufen wird.

InputMappingId wird nur für ACPI-enumerierte Geräte auf ARM64 verwendet. In allen anderen Fällen muss dieser Wert null sein.

Wenn mehrere Geräte gleichzeitig mit dem im IOMMU_DOMAIN_ATTACH_DEVICE-Aufruf angegebenen MappingCount-Wert angefügt werden, können diese Geräte nur als Gruppe getrennt werden, indem ein InputMappingId-Wert angegeben wird, der dem InputMappingIdBase-Wert von [IOMMU_DOMAIN_ATTACH_DEVICE] entspricht, der beim Anfügen verwendet wird.

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

Anforderungen

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

Freigeben über