IStiDeviceControl：：WriteToErrorLog 方法 （stiusd.h）

IStiDeviceControl：：WriteToErrorLog 方法可讓使用者模式的仍然影像 minidriver 將訊息寫入靜止影像錯誤記錄檔中。

語法

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 方法的輸入。

要求