IAMErrorLog::LogError 方法

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,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更新。 Qedit.h 在 Windows 7 和 .NET Framework 3.5 Service Pack 1 的Microsoft Windows SDK中不可用。

 

要求

要求
标头
Qedit.h

Strmiids.lib

另请参阅

IAMErrorLog 接口

错误和成功代码