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 |