IFilterGraph::Reconnect-Methode (strmif.h)

  • Artikel

[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 Reconnect -Methode trennt einen Pin und verbindet ihn dann erneut mit demselben Pin.

Anwendungen sollten diese Methode nicht aufrufen. Sie wird während des Diagrammerstellungsprozesses von Filtern aufgerufen.

Syntax

HRESULT Reconnect(
  [in] IPin *ppin
);

Parameter

[in] ppin

Zeiger auf die IPin-Schnittstelle des Pins, der wiederhergestellt werden soll.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_FAIL
 Fehler.
E_POINTER
 NULL-Zeigerargument.
VFW_E_NOT_CONNECTED
 Der Pin ist nicht verbunden.
VFW_E_WRONG_STATE
 Der Filter wird nicht beendet.

Hinweise

Diese Methode ist veraltet; Verwenden Sie stattdessen die IFilterGraph2::ReconnectEx-Methode .

Filter können diese Methode aufrufen, um eine Pinverbindung neu auszuhandeln. Die -Methode wird in einem separaten Thread ausgeführt. Rufen Sie vor dem Aufrufen dieser Methode IPin::QueryAccept auf der anderen Pin auf, um sicherzustellen, dass der Versuch der erneuten Verbindung erfolgreich ist. Rufen Sie diese Methode nur auf, wenn QueryAccept S_OK zurückgibt. Andernfalls kann die erneute Verbindung fehlschlagen, da die erneute Verbindung asynchron durchgeführt wird, obwohl die Reconnect Methode erfolgreich ist, sodass der Filtergraph in einem inkonsistenten Zustand bleibt.

Anforderungen

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

Weitere Informationen

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle

Erneutes Verbinden von Pins