IAMFilterGraphCallback::UnableToRender 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 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

另请参阅

IAMFilterGraphCallback 接口

智能连接