IPin：：BeginFlush 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 BeginFlush 开始刷新操作。
应用程序不应调用此方法。 此方法由其他筛选器调用，以刷新图形中的数据。
语法
HRESULT BeginFlush();
返回值
返回 HRESULT 值。 可能的值包括以下值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
引脚是输出引脚。 |
注解
仅在输入引脚上调用此方法。 输出引脚返回E_UNEXPECTED。
在刷新操作中，筛选器会丢弃它正在处理的任何数据。 它会拒绝新数据，直到刷新完成。 当上游引脚调用 IPin：：EndFlush 方法时，刷新完成。 刷新使筛选器图在事件更改正常数据流时具有更高的响应能力。 例如，刷新在查找期间发生。
调用 时 BeginFlush ，筛选器将执行以下步骤：
- 将
IPin::BeginFlush调用传递到下游。 - 设置导致所有数据流式处理方法失败的内部标志，例如 IMemInputPin：：Receive。
- 从对 Receive 方法的任何阻止调用中返回 。
BeginFlush 通知到达呈现器筛选器时，呈现器释放它保存的所有样本。
调用 后BeginFlush，引脚会拒绝上游的所有样本，返回值为 S_FALSE，直到调用 IPin：：EndFlush 方法。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |