次の方法で共有

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 ディレクトリにあります。 コントロール パネルを使用すると、エラー ログに書き込まれる静止画像のエラーの種類 (情報、警告、またはエラー) を選択できます (変更できないレジストリ エントリ 参照)。

エラー メッセージは、デバイスのハードウェア障害などの重大なエラー状態のために予約する必要があります。 情報メッセージは、独自のデバッグ目的で使用できます。 ログに記録されたメッセージはユーザーには表示されませんが、ユーザーの問題をデバッグするためにサポート エンジニアによって使用される場合があります。

静止画像ミニドライバーは、IStiUSD::Initialize メソッドへの入力として、IStiDeviceControl インターフェイス ポインターを受け取ります。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー stiusd.h (Stiusd.h を含む)