CBasePin.BreakConnect-Methode

  • 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 BreakConnect -Methode gibt den Pin von einer Verbindung frei.

Syntax

virtual HRESULT BreakConnect();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Diese Methode wird während der Pintrennung von der CBasePin::D isconnect-Methode aufgerufen. Sie wird auch während eines Verbindungsversuchs aufgerufen, wenn die CBasePin::CheckConnect-Methode fehlschlägt.

Diese Methode muss alle Ressourcen freigeben, die von der CheckConnect-Methode abgerufen wurden. Wenn CheckConnect beispielsweise Arbeitsspeicher zuweist, BreakConnect sollte der Arbeitsspeicher freigegeben werden. Wenn CheckConnect den Verbindungspin für eine Schnittstelle abfragt, BreakConnect sollte die Schnittstelle freigegeben werden.

Beachten Sie, dass BreakConnect ohne einen entsprechenden Aufruf von CompleteConnect aufgerufen werden kann. Daher können Sie nicht davon ausgehen, dass CompleteConnect zuvor aufgerufen wurde.

Anforderungen

Anforderung Wert
Header
Amfilter.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBasePin-Klasse