IAMGraphBuilderCallback：：CreatedFilter 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
Filter Graph 管理器在创建筛选器后、尝试连接筛选器之前调用此方法。
语法
HRESULT CreatedFilter(
IBaseFilter *pFil
);
参数
pFil
指向筛选器的 IBaseFilter 接口的指针。
返回值
如果方法返回成功代码，则 Filter Graph 管理器会尝试连接筛选器。 如果方法返回失败代码，则 Filter Graph 管理器将拒绝该筛选器。
注解
此方法使客户端能够在创建筛选器后立即对其进行配置。 视频混合呈现器是筛选器的主要示例，它要求在连接之前对其进行配置。 大多数其他 DirectShow 筛选器都可以在连接后进行配置。
Filter Graph 管理器在调用此方法时保留图形范围的关键部分。 因此，回调方法应避免调用 Filter Graph Manager 上的任何方法，或筛选器上可能更改图形状态 (的任何方法，例如断开) 引脚的连接。 这样做可能会导致死锁或其他意外行为。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |