IAMErrorLog：：LogError 方法
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media 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中不可用。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
另请参阅