IGraphConfigCallback::Reconfigure-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Reconfigure -Methode ist eine Rückrufmethode, die an IGraphConfig::Reconfigure übergeben wird.

Syntax

HRESULT Reconfigure(
  PVOID pvContext,
  DWORD dwFlags
);

Parameter

pvContext

Der wert, der im pvContext-Parameter der IGraphConfig::Reconfigure-Methode übergeben wird.

dwFlags

Der wert, der im dwFlags-Parameter der IGraphConfig::Reconfigure-Methode übergeben wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein HRESULT-Wert zurückgegeben, der die Fehlerursache angibt.

Hinweise

Wenn Ihre Anwendung oder Ihr Filter IGraphConfig::Reconfigure aufruft, müssen Sie diese Methode implementieren und als Rückruf übergeben. Die IGraphConfig::Reconfigure-Methode ruft vor dem Aufrufen der Reconfigure Methode eine Sperre für den Filtergraphen ab. Ihre -Methode verarbeitet dann alle anderen Details der dynamischen Grapherstellung.

Wenn diese Methode erfolgreich ist, versucht IGraphConfig::Reconfigure , alle Filter im Graphen wieder in einen ausgeführten Zustand zu versetzen. Wenn die Methode fehlschlägt, gibt IGraphConfig::Reconfigure den von dieser Methode zurückgegebenen Fehlercode zurück.

Diese Methode ermöglicht eine spezialisierte Graphneuerstellung. Einen einfacheren Ansatz für die Erstellung dynamischer Diagramme finden Sie unter IGraphConfig::Reconnect.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IGraphConfigCallback-Schnittstelle