Edit

Share via

IOMMU_SET_DEVICE_FAULT_REPORTING callback function (wdm.h)

  • Article

This routine sets the device fault reporting state to a device already attached to a domain.

It is driver's responsibility to ensure that this function is not called concurrently with any IommuDomainAttachDevice or IommuDomainDetachDevice calls on the same device.

Syntax

IOMMU_SET_DEVICE_FAULT_REPORTING IommuSetDeviceFaultReporting;

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

Parameters

[In] PhysicalDeviceObject

A pointer the physical device object (PDO) in the device stack of the device.

[In] InputMappingIdBase

The input mapping base for the device's desired stream.

[In] Enable

a BOOLEAN value that indicates whether to enable fault reporting for the device.

[in] FaultConfig

Optional. A pointer to DEVICE_FAULT_CONFIGURATION. This is only used for enabling fault reporting.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS values error code. For more information, see NTSTATUS Values.

Remarks

Register your implementation of this callback function by setting SetDeviceFaultReporting of _DMA_IOMMU_INTERFACE.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809.
Header wdm.h (include Wdm.h)