CBasePin.GetConnected-Methode
[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 GetConnected -Methode ruft den Pin ab, der mit diesem Pin verbunden ist.
Syntax
IPin* GetConnected();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Gibt einen Zeiger auf die IPin-Schnittstelle des anderen Pins zurück.
Bemerkungen
Wenn der Pin nicht verbunden ist, gibt diese Methode NULL zurück. Rufen Sie die CBasePin::IsConnected-Methode auf , um zu bestimmen, ob der Pin verbunden ist.
Die -Methode ruft AddRef nicht auf der IPin-Schnittstelle auf, sodass der Aufrufer die Schnittstelle nicht freigeben sollte.
Beispiele
Da die Verweisanzahl für den zurückgegebenen Zeiger nicht erhöht wird, können Sie Methodenaufrufe verketten:
if (m_MyPin->IsConnected())
{
m_MyPin->GetConnected()->EndOfStream();
}
Dieses Codierungsmuster ist sehr praktisch; Aber wie das Beispiel zeigt, müssen Sie darauf achten, dass Sie keinen NULL-Zeiger dereferenzieren, wenn der Pin nicht verbunden ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|