Freigeben über


CTransformFilter.GetPin-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 GetPin -Methode ruft eine Pin ab.

Syntax

virtual CBasePin* GetPin(
   int n
);

Parameter

n

Die Nummer des angegebenen Pins, indiziert von null. Bei diesem Filter ist Pin 0 der Eingabestift und Pin 1 der Ausgabestift.

Rückgabewert

Gibt einen Zeiger auf das CBasePin-Objekt zurück, das den Pin implementiert, oder NULL , wenn die Methode fehlschlägt.

Bemerkungen

Diese Methode implementiert die reine virtuelle CBaseFilter::GetPin-Methode . Wenn die Methode zum ersten Mal aufgerufen wird, werden beide Pins erstellt.

Diese Methode erhöht die Verweisanzahl für den zurückgegebenen Pin nicht, sodass der zurückgegebene Pin keine ausstehende Verweisanzahl aufweist. Wenn der Aufrufer einen Verweis auf den Pin beibehalten muss, sollte er die IUnknown::AddRef-Methode auf der Pin aufrufen.

Wenn der Filter die Standard-Pins CTransformInputPin und CTransformOutputPin verwendet, müssen Sie diese Methode wahrscheinlich nicht überschreiben. Wenn der Filter jedoch Pins verwendet, die diese Klassen erweitern, müssen Sie diese Methode überschreiben, um Pins dieses Typs zu erstellen.

Anforderungen

Anforderung Wert
Header
Transfrm.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CTransformFilter-Klasse