IddCxReportCriticalError function (iddcx.h)
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 |