IAMOpenProgress 接口 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

接口 IAMOpenProgress 报告文件打开操作的进度,并使应用程序能够取消该操作。

通过网络打开文件的筛选器可以公开此接口。 应用程序可以使用它来查询下载进度,或取消下载。 如果网络没有响应, IGraphBuilder::RenderFile 等方法可能会无限期阻塞。 若要防止应用程序阻塞,请创建一个用于 IAMOpenProgress 监视进度的工作线程。 如果发生预定义超时,或者为了响应用户的命令,工作线程可以取消操作。

文件源 (URL) 筛选器支持此接口。

继承

IAMOpenProgress 接口继承自 IUnknown 接口。 IAMOpenProgress 还具有以下类型的成员:

方法

IAMOpenProgress 接口具有这些方法。

 
IAMOpenProgress::AbortOperation

AbortOperation 方法取消文件打开操作。
IAMOpenProgress::QueryProgress

QueryProgress 方法检索文件打开操作的进度。

要求

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