IStiDeviceControl::WriteToErrorLog 方法 (stiusd.h)

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 目錄中。 主控台可讓使用者選取哪些仍為影像錯誤類型, (參考、警告或錯誤) 寫入錯誤記錄檔, (請參閱不可修改的登錄專案) 。

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

仍然影像 minidriver 會收到 IStiDeviceControl 介面指標作為其 IStiUSD::Initialize 方法的輸入。

必要條件

   
目標平臺 桌面
標頭 stiusd.h (包含 Stiusd.h)