iddCxReportCriticalError 函式 (iddcx.h)
IddCxReportCriticalError 是由間接顯示驅動程式呼叫的 OS 回呼函式, (IDD) 來報告重大錯誤。
語法
NTSTATUS IddCxReportCriticalError(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_REPORTCRITICALERROR *pInArgs
);
參數
AdapterObject
發生重大錯誤的配接器 IDDCX_ADAPTER 物件。 如果在建立IDDCX_ADAPTER之前發生錯誤,IDD 應該傳遞 nullptr
。
pInArgs
包含嚴重錯誤的錯誤碼 之IDARG_IN_REPORTCRITICALERROR 結構的指標。
傳回值
如果例程成功,它永遠不會返回驅動程式,因為驅動程序進程將會終止。
備註
當 IDD 呼叫 IddCxCriticalError 時,OS 會執行下列動作:
- 使用下列錯誤檢查程式代碼檢查驅動程式:
(pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode
。 建議驅動程式使用主要程式代碼和次要程式代碼的唯一組合,以便在當機和 Watson 報告中識別這些案例。 - 根據 UMDF 驅動程式重新啟動原則終止驅動程式進程並重新啟動。
- 如果呼叫端是遠端 IDD,請中斷使用者工作階段的連線。
產生使用者模式記憶體傾印時,驅動程式應該會將任何有用的偵錯資訊放在稱為 IddCxCriticalError之函式堆疊上。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 |
標頭 | iddcx.h |