IAMErrorLog::LogError

LogError メソッドは、エラーをログに記録する。アプリケーションでこのメソッドを呼び出す必要はない。このメソッドは、レンダリング エラーに応答して内部的に呼び出される。

構文

  HRESULT LogError(
    LONG Severity,
    BSTR ErrorString,
    LONG ErrorCode,
    HRESULT hresult,
    VARIANT *pExtraInfo
);

パラメータ

Severity

予約済み。使用不可。

ErrorString

エラーのテキストを含む文字列値。

ErrorCode

エラー コード。

hresult

エラーを引き起こしたメソッド呼び出しで返された HRESULT 値。

pExtraInfo

[in] エラーに関する追加情報が含まれる VARIANT 型へのポインタ。

戻り値

HRESULT 値を返す。hresult 引数の値を返す。

注意

このメソッドの中で、pExtraInfo が指す VARIANT を解放してはならない。また、VARIANT はメソッドが戻った後は無効になるので、後で参照してはならない。

このメソッドが可能な限り早く戻るように実装すること。このメソッドの中で、プログラムの実行を停止させるような関数呼び出しをしてはならない。たとえば、ウィンドウ メッセージの送信、イベントのブロックなど、実行の妨げとなる Microsoft® Win32® 関数を呼び出してはならない。そうしたことを行うと、コンピュータが応答を停止したり、"ハング" することがある。

DES で定義されているエラーの一覧、および pExtraInfo が指す VARIANT の意味とデータ型については、「レンダリング エラー」を参照すること。

要件

ヘッダー : Qedit.h をインクルードする。このヘッダー ファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。

ライブラリ : strmiids.lib を使用。

参照

• IAMErrorLog インターフェイス
• エラー コードと成功コード