IFilterGraph::Reconnect-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 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.

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

Weitere Informationen

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle

Erneutes Verbinden von Pins