IGraphConfigCallback::Reconfigure 方法 (strmif.h)

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

方法 Reconfigure 是传递给 IGraphConfig::Reconfigure 的回调方法。

语法

HRESULT Reconfigure(
  PVOID pvContext,
  DWORD dwFlags
);

参数

pvContext

在 IGraphConfig::Reconfigure 方法的 pvContext 参数中传递的值。

dwFlags

在 IGraphConfig::Reconfigure 方法的 dwFlags 参数中传递的值。

返回值

如果成功,则返回S_OK。 否则,返回一个 HRESULT 值,该值指示错误的原因。

注解

如果应用程序或筛选器调用 IGraphConfig::Reconfigure,则必须实现此方法并将其作为回调传递。 IGraphConfig::Reconfigure 方法在调用Reconfigure方法之前获取筛选器图上的锁。 然后,方法处理动态图形构建的所有其他详细信息。

如果此方法成功, IGraphConfig::Reconfigure 会尝试将图形中的所有筛选器重新置于运行状态。 如果方法失败, IGraphConfig::Reconfigure 将返回此方法返回的任何错误代码。

此方法允许进行专用图形重新生成。 有关动态图形构建的更简单方法,请参阅 IGraphConfig::重新连接

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IGraphConfigCallback 接口