IddCxReportCriticalError 函式 (iddcx.h)
IddCxReportCriticalError 是間接顯示驅動程式 (IDD) 呼叫的 OS 回呼函式,可報告嚴重錯誤。
語法
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 |