Metodo IGraphConfigCallback::Reconfigure (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Reconfigure metodo è un metodo di callback passato a IGraphConfig::Reconfigure.

Sintassi

HRESULT Reconfigure(
  PVOID pvContext,
  DWORD dwFlags
);

Parametri

pvContext

Valore passato nel parametro pvContext del metodo IGraphConfig::Reconfigure.

dwFlags

Valore passato nel parametro dwFlags del metodo IGraphConfig::Reconfigure.

Valore restituito

Restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore HRESULT che indica la causa dell'errore.

Commenti

Se l'applicazione o il filtro chiama IGraphConfig::Reconfigure, è necessario implementare questo metodo e passarlo come callback. Il metodo IGraphConfig::Reconfigure ottiene un blocco sul grafico del filtro prima di chiamare il Reconfigure metodo . Il metodo gestisce quindi tutti gli altri dettagli della compilazione dinamica del grafo.

Se questo metodo ha esito positivo, IGraphConfig::Reconfigure tenta di inserire nuovamente tutti i filtri nel grafico in uno stato di esecuzione. Se il metodo ha esito negativo, IGraphConfig::Reconfigure restituisce il codice di errore restituito da questo metodo.

Questo metodo consente la ricompilazione del grafo specializzata. Per un approccio più semplice alla compilazione dinamica del grafo, vedere IGraphConfig::Reconnect.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IGraphConfigCallback