CTransInPlaceFilter.GetPin-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die GetPin
-Methode ruft einen Pin ab.
virtual CBasePin* GetPin(
int n
);
-
n
-
Nummer des angegebenen Pins, indiziert von 0. Bei diesem Filter ist Pin 0 der Eingabestift, und Pin 1 ist der Ausgabestift.
Gibt einen Zeiger auf das CBasePin-Objekt zurück, das den Pin implementiert, oder NULL , wenn die Methode fehlschlägt.
Diese Methode überschreibt die CTransformFilter::GetPin-Methode . Beim ersten Aufruf der Methode 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 der Pin beibehalten muss, sollte er die IUnknown::AddRef-Methode an der Pin aufrufen.
Wenn der Filter die Standardpins CTransInPlaceInputPin und CTransInPlaceOutputPin verwendet, müssen Sie diese Methode wahrscheinlich nicht außer Kraft setzen. Wenn der Filter jedoch Pins verwendet, die diese Klassen erweitern, müssen Sie diese Methode überschreiben, um Pins dieses Typs zu erstellen.
Anforderung | Wert |
---|---|
Header |
|
Bibliothek |
|