IAsyncReader 接口 (strmif.h)

  • 项目

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

接口 IAsyncReader 对筛选器执行异步数据请求。

此接口由执行异步读取操作的输出引脚公开。 接口由下游筛选器上的输入引脚使用。 应用程序不使用此接口。 异步文件源筛选器在其输出引脚上公开此接口。

筛选器开发人员：如果输出引脚以字节流 (MEDIATYPE_Stream) 的形式提供数据并支持拉取模型，则实现此接口。 在连接过程中，检查下游引脚是否查询IAsyncReader接口。 否则，引脚应使连接失败或建立一些其他传输。 (如果引脚派生自 CBasePin，请在 CBasePin：：CheckConnect 方法中执行此检查。)

有关使用此接口的详细信息，请参阅以下主题：

继承

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

方法

IAsyncReader 接口具有这些方法。

 
IAsyncReader：：BeginFlush

BeginFlush 方法开始刷新操作。 (IAsyncReader.BeginFlush)
IAsyncReader：：EndFlush

EndFlush 方法结束刷新操作。 (IAsyncReader.EndFlush)
IAsyncReader：：Length

Length 方法检索流的总长度。
IAsyncReader：：Request

Request 方法对异步数据请求进行排队。
IAsyncReader：：RequestAllocator

RequestAllocator 方法在引脚连接期间请求分配器。
IAsyncReader：：SyncRead

SyncRead 方法执行同步读取。 方法将阻止，直到请求完成。 文件位置和缓冲区地址不必对齐。 如果请求不一致，方法将执行缓冲读取操作。
IAsyncReader：：SyncReadAligned

SyncReadAligned 方法执行同步读取。 方法将阻止，直到请求完成。 文件位置和缓冲区地址必须对齐;检查所需的对齐方式的分配器属性。
IAsyncReader：：WaitForNext

WaitForNext 方法等待下一个挂起的读取请求完成。

要求

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