IOMMU_SET_DEVICE_FAULT_REPORTING Rückruffunktion (wdm.h)

Artikel
07.02.2025

Diese Routine legt den Zustand der Gerätefehlerberichterstattung 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 allen IommuDomainAttachDevice oder IommuDomainDetachDevice Aufrufe auf demselben Gerät aufgerufen wird.

Syntax

C++

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 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] Enable

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

[in] FaultConfig

Wahlfrei. 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. Geben Sie andernfalls einen entsprechenden NTSTATUS-Wertefehlercode zurück. Weitere Informationen finden Sie unter NTSTATUS Values.

Bemerkungen

Registrieren Sie Die Implementierung dieser Rückruffunktion, indem Sie SetDeviceFaultReporting von _DMA_IOMMU_INTERFACEfestlegen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1809.
Header-	wdm.h (include Wdm.h)

Freigeben über