Метод IGraphConfigCallback::Reconfigure (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод Reconfigure является методом обратного вызова, передаваемым в IGraphConfig::Reconfigure.
Синтаксис
HRESULT Reconfigure(
PVOID pvContext,
DWORD dwFlags
);
Параметры
pvContext
Значение, переданное в параметре pvContext метода IGraphConfig::Reconfigure.
dwFlags
Значение, переданное в параметре dwFlags метода IGraphConfig::Reconfigure.
Возвращаемое значение
В случае успешного выполнения возвращает S_OK. В противном случае возвращает значение HRESULT , указывающее причину ошибки.
Комментарии
Если приложение или фильтр вызывает IGraphConfig::Reconfigure, необходимо реализовать этот метод и передать его в качестве обратного вызова. Метод IGraphConfig::Reconfigure получает блокировку графа фильтра перед вызовом Reconfigure метода . Затем метод обрабатывает все остальные сведения о создании динамического графа.
Если этот метод будет выполнен успешно, IGraphConfig::Reconfigure пытается вернуть все фильтры графа в состояние выполнения. В случае сбоя метода IGraphConfig::Reconfigure возвращает код ошибки, возвращенный этим методом.
Этот метод позволяет выполнять специализированное перестроение графов. Более простой подход к созданию динамических графов см. в разделе IGraphConfig::Reconnect.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |