IFileSourceFilter：：Load 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 Load 会导致源筛选器加载媒体文件。

语法

HRESULT Load(
  [in] LPCOLESTR           pszFileName,
  [in] const AM_MEDIA_TYPE *pmt
);

参数

[in] pszFileName

指向要打开的文件的名称的指针。

[in] pmt

指向文件的媒体类型的指针。 这可以为 NULL。

返回值

返回 HRESULT 值。

备注

此方法初始化 接口。 它不是为加载多个文件而设计的，并且第一次调用后对此方法的任何调用都将失败。

对于 “文件源 (异步) 筛选器， pszFileName 指定本地文件的绝对路径名。 对于 “文件源 (URL) 筛选器， pszFileName 指定要下载的文件的 URL。 对于其他筛选器实现， pszFileName 可能需要文件名或 URL，具体取决于筛选器。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IFileSourceFilter 接口