FPGA_CONTROL_ERROR_REPORTING callback function (wdm.h)

Artikel
02/22/2024

Reserved for future use.

Toggles the error reporting for the FPGA device and its parent bridge.

Syntax

FPGA_CONTROL_ERROR_REPORTING FpgaControlErrorReporting;

NTSTATUS FpgaControlErrorReporting(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG UncorrectableMask,
  [_In_]                                      ULONG CorrectableMask,
  [_In_]                                      BOOLEAN DisableErrorReporting
)
{...}

Parameters

Context

The handle to the bus extension.

[_In_] UncorrectableMask

A bitwise mask of flags defined in PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK that indicates the uncorrectable masks to be toggled.

[_In_] CorrectableMask

A bitwise mask of flags defined in PCI_EXPRESS_CORRECTABLE_ERROR_MASK that indicates the correctable masks to be toggled.

[_In_] DisableErrorReporting

A flag indicates whether the error reporting is being disabled or enabled.

Return value

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

Remarks

A device driver that successfully queries for the GUID_PCI_FPGA_CONTROL_INTERFACE interface receives a pointer to a FPGA_CONTROL_INTERFACE structure in which the driver sets the ControlErrorReporting member to a pointer to its implementation of the FPGA_CONTROL_CONFIG_SPACE callback function.

This callback function expects that the FPGA device is in D0 state and its configuration space has not been locked.
When DisableErrorReporting is set to TRUE, each set bit in the given masks is set in the AER capability of the FPGA device. When DisableErrorReporting is set to FALSE, the original AER masks will be restored.

Requirements

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

Delen via