(stiusd.h) IStiDeviceControl::WriteToErrorLog 方法

IStiDeviceControl::WriteToErrorLog 方法可讓使用者模式仍為影像迷你驅動程式,將訊息寫入至仍然的映像錯誤記錄檔。

語法

HRESULT WriteToErrorLog(
  DWORD   dwMessageType,
  LPCWSTR pszMessage,
  DWORD   dwErrorCode
);

參數

dwMessageType

代表訊息類型的呼叫端提供的常數值。 Sti.h 中定義了下列值:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

呼叫端提供的訊息字串指標,要寫入記錄檔。

dwErrorCode

未使用

傳回值

如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。

備註

仍然的影像錯誤記錄檔名為 sti_trace.log ,且位於 Windows 目錄中。 控制台 可讓使用者 (資訊、警告或) 錯誤記錄檔寫入錯誤記錄檔 (映射錯誤類型, (請參閱不可修改的登錄專案) 。

錯誤訊息應保留給重大錯誤狀況,例如裝置硬體故障。 參考訊息可用於您自己的偵錯用途。 使用者看不到已記錄的訊息,但支持工程師可能會使用這些訊息來協助偵錯用戶的問題。

仍然的影像迷你驅動程式會收到 IStiDeviceControl 介面指標作為其 IStiUSD::Initialize 方法的輸入。

規格需求

需求
目標平台 桌面
標頭 stiusd.h (包含 Stiusd.h)