次の方法で共有

IAMErrorLog::LogError メソッド

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

注意

[非推奨。 この API は、Windows の今後のリリースから削除される可能性があります。]

 

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

構文

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

パラメーター

重大度

予約済み。 使用しないでください。

ErrorString

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

ErrorCode

エラー コード。

hresult

エラーの原因となったメソッド呼び出しによって返された HRESULT 値。

pExtraInfo [in]

エラーに関する追加情報を含む VARIANT へのポインター。

戻り値

hresult パラメーターの値を返します。

解説

このメソッド内では、pExtraInfo によって指される VARIANT を解放しないでください。 また、メソッドが戻った後に VARIANT が無効になるため、後で参照しないでください。

可能な限り迅速にを返すには、このメソッドを実装します。 プログラムの実行をブロックする可能性があるこのメソッド内から関数呼び出しを行わないでください。 たとえば、ウィンドウ メッセージを送信したり、イベントをブロックしたり、実行をブロックしたりする関数を呼び出さないでください。 これを行うと、コンピューターが応答を停止する可能性があります。

DES によって定義されたエラーの一覧と、pExtraInfo によって指される VARIANT の意味とデータ型については、「レンダリング エラー」を参照してください。

注意

ヘッダー ファイル Qedit.h は、バージョン 7 より後の Direct3D ヘッダーと互換性がありません。

 

注意

Qedit.h を取得するには、Windows Vista および .NET Framework 3.0 用の Microsoft Windows SDK Update をダウンロードします。 Qedit.h は、Windows 7 および .NET Framework 3.5 Service Pack 1 のMicrosoft Windows SDKでは使用できません。

 

要件

要件 値
ヘッダー
Qedit.h
ライブラリ
Strmiids.lib

関連項目

IAMErrorLog インターフェイス

エラーコードと成功コード