呈现错误
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
注意
[已弃用。 此 API 可能会从 Windows 的未来版本中删除。]
Microsoft® DirectShow® Editing Services (DES) 定义用于记录呈现错误的各种错误代码。 如果项目未正确呈现，呈现引擎将调用 IAMErrorLog：：LogError 方法。 下表汇总了提供给 LogError 的参数：
- 错误代码包含在 ErrorCode 参数中。
- 说明包含在 ErrorString 参数中。
- 说明包含在 ErrorString 参数中。
- 如果有额外信息，则 VARIANT 类型包含在 pExtraInfo 指向的 VARIANT 的 vt 成员中。
注意
此处所述的错误代码不是 HRESULT 值。 有关特定于 DES 的 HRESULT 返回值的列表，请参阅 错误和成功代码。
| 错误代码 | 说明 | 额外的信息 | Variant 类型 |
|---|---|---|---|
| DEX_IDS_BAD_SOURCE_NAME | 文件名不存在，或者 DirectShow 无法识别文件扩展名。 | 文件名 | BSTR |
| DEX_IDS_BAD_SOURCE_NAME2 | 文件类型与文件扩展名不匹配，或者文件已损坏。 | 文件名 | BSTR |
| DEX_IDS_MISSING_SOURCE_NAME | 文件名是必需的，但未提供。 | 无 | 不适用 |
| DEX_IDS_UNKNOWN_SOURCE | 无法分析此源提供的数据源。 | 无 | 不适用 |
| DEX_IDS_INSTALL_PROBLEM | 意外错误。 某些 DirectShow 组件未正确安装。 | 无 | 不适用 |
| DEX_IDS_NO_SOURCE_NAMES | 源筛选器不接受文件名。 | 无 | 不适用 |
| DEX_IDS_BAD_MEDIATYPE | 不支持组的媒体类型。 | 组号 | int |
| DEX_IDS_STREAM_NUMBER | 此源的流号无效。 | 流编号 | int |
| DEX_IDS_OUTOFMEMORY | 内存不足。 | 无 | 不适用 |
| DEX_IDS_DIBSEQ_NOTALLSAME | 序列中的一个位图与其他位图的类型不同。 | 位图名称 | BSTR |
| DEX_IDS_CLIPTOOSHORT | 剪辑的媒体时间无效，或者与设备无关的位图 (DIB) 序列太短。
注意： 如果发生其他呈现错误，则即使媒体时间有效，也可能发生此错误。 |
无 | 不适用 |
| DEX_IDS_INVALID_DXT | 效果或过渡) CLSID (类标识符无效。 | CLSID | BSTR |
| DEX_IDS_INVALID_DEFAULT_DXT | 默认效果或过渡的 CLSID 无效。 | CLSID | BSTR |
| DEX_IDS_NO_3D | DirectX 版本不支持三维转换。 | CLSID | BSTR |
| DEX_IDS_BROKEN_DXT | 此效果不是正确的类型，或者已损坏。 | CLSID | BSTR |
| DEX_IDS_NO_SUCH_PROPERTY | 对象上不存在此类属性。 | 属性名称 | BSTR |
| DEX_IDS_ILLEGAL_PROPERTY_VAL | 此属性的非法值。 | 指定的值 | VARIANT |
| DEX_IDS_INVALID_XML | XML 文件中的语法错误。 | 行号 | VT_I4 (4 字节整数) |
| DEX_IDS_CANT_FIND_FILTER | 找不到按类别和实例在 XML 中指定的筛选器。 | 实例) (友好名称 | BSTR |
| DEX_IDS_DISK_WRITE_ERROR | 将 XML 文件写入磁盘时出错。 | 无 | 不适用 |
| DEX_IDS_INVALID_AUDIO_FX | CLSID 不是有效的 DirectShow 音频效果筛选器。 | CLSID | BSTR |
| DEX_IDS_CANT_FIND_COMPRESSOR | 找不到用于生成指定压缩格式的压缩器。 | 无 | 不适用 |
不应发生以下错误。 如果遇到其中一个错误，请向 Microsoft 发送 bug 报告。
| 错误代码 | 说明 |
|---|---|
| DEX_IDS_TIMELINE_PARSE | 分析时间线时出现意外错误。 |
| DEX_IDS_GRAPH_ERROR | 生成筛选器图时出现意外错误。 |
| DEX_IDS_GRID_ERROR | 内部网格出现意外错误。 |
| DEX_IDS_INTERFACE_ERROR | 获取接口时出现意外错误。 |