使用媒体定位符
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
[此 API 不受支持,将来可能会更改或不可用。]
媒体定位器是一个帮助程序对象,用于验证文件名并搜索本地或网络目录中缺少的文件。 媒体检测器会保留目录路径的缓存,这些路径在过去搜索中已成功找到文件。 若要查找文件,它会搜索其缓存中的目录。 否则,媒体检测器可以显示“打开文件”对话框,以便用户手动查找文件。 假设用户找到文件,媒体定位器会将新目录添加到其缓存。 媒体定位符公开 IMediaLocator 接口。
通常,应用程序不会直接创建媒体定位符的实例。 相反,时间线和呈现引擎提供以下方法,用于使用媒体检测器验证文件名。
- 若要验证时间线中的文件名,请调用 IAMTimeline::ValidateSourceNames。 (可选)此方法还会使用正确的文件名更新源对象。
- 若要在呈现项目时验证文件名,请调用 IRenderEngine::SetSourceNameValidation。
这两种方法都采用控制媒体定位符行为的标志。 例如,可以将搜索限制为本地目录。
相关主题