Edit

IddCxReportCriticalError function (iddcx.h)

  • Article

IddCxReportCriticalError is an OS callback function called by an indirect display driver (IDD) to report a critical error.

Syntax

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

Parameters

AdapterObject

An IDDCX_ADAPTER object of the adapter on which the critical error occurred. If the error occurred before an IDDCX_ADAPTER was created, the IDD should pass nullptr.

pInArgs

Pointer to an IDARG_IN_REPORTCRITICALERROR structure containing the error code of the critical error.

Return value

If the routine succeeds it never returns to the driver because the driver process will be terminated.

Remarks

When an IDD calls IddCxCriticalError, the OS will do the following:

  • Bugcheck the driver with the following bugcheck code: (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode. It is recommended that the driver use a unique combination of a major code and minor code so these cases can be identified in crashes and Watson reports.
  • Terminate the driver process and restart according to the UMDF driver restart policy.
  • If the caller is a remote IDD, disconnect the user session.

As a user mode memory dump is generated, the driver should place any useful debug information on the stack of the function that called IddCxCriticalError.

Requirements

Requirement Value
Minimum supported client Windows 10
Header iddcx.h

See also

IDARG_IN_REPORTCRITICALERROR