IAMFilterGraphCallback::UnableToRender 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
UnableToRender
如果无法找到任何筛选器组合来呈现指定引脚,则 Filter Graph 管理器将调用 该方法。
语法
HRESULT UnableToRender(
IPin *pPin
);
参数
pPin
指定无法呈现的图 钉的 IPin 接口。
返回值
如果返回值为S_OK,则此 Filter Graph 管理器将尝试再次呈现图钉。 对于任何其他返回值(包括S_FALSE和其他成功代码),Filter Graph 管理器会继续正常生成图形。 通常,它会拒绝当前筛选器并尝试使用其他筛选器。
注解
Filter Graph 管理器在调用此方法时保留图形范围的关键部分。 因此,回调方法应避免调用 Filter Graph Manager 上的任何方法,或筛选器上可能更改图形状态 (的任何方法,例如断开) 引脚的连接。 这样做可能会导致死锁或其他意外行为。 但是,可以安全地查询固定接口或检查引脚的首选媒体类型。 此方法main用于注册新筛选器,例如解码器。
此方法使用 thiscall 调用约定,而不是__stdcall。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |