IGraphConfigCallback：：Reconfigure 方法 (strmif.h)

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