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