IOMMU_SET_DEVICE_FAULT_REPORTING Rückruffunktion (wdm.h)

Artikel
03/01/2024

Diese Routine legt den Gerätefehlerberichtsstatus auf ein Gerät fest, das bereits an eine Domäne angefügt ist.

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

Syntax

IOMMU_SET_DEVICE_FAULT_REPORTING IommuSetDeviceFaultReporting;

NTSTATUS IommuSetDeviceFaultReporting(
  [In] PDEVICE_OBJECT PhysicalDeviceObject,
  [In] ULONG InputMappingIdBase,
  [In] BOOLEAN Enable,
  [in] PDEVICE_FAULT_CONFIGURATION FaultConfig
)
{...}

Parameter

[In] PhysicalDeviceObject

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

[In] InputMappingIdBase

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

[In] Enable

ein BOOLEAN-Wert, der angibt, ob die Fehlerberichterstattung für das Gerät aktiviert werden soll.

[in] FaultConfig

Optional. Ein Zeiger auf DEVICE_FAULT_CONFIGURATION. Dies wird nur zum Aktivieren der Fehlerberichterstattung verwendet.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender Fehlercode für NTSTATUS-Werte zurückgegeben. Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie SetDeviceFaultReporting für _DMA_IOMMU_INTERFACE festlegen.

Anforderungen

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

Freigeben über