IBaseFilter::FindPin-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 FindPin -Methode ruft den Pin mit dem angegebenen Bezeichner ab.
Syntax
HRESULT FindPin(
[in] LPCWSTR Id,
[out] IPin **ppPin
);
Parameter
[in] Id
Zeiger auf eine konstante Breitzeichenzeichenfolge, die den Pin identifiziert. Rufen Sie die IPin::QueryId-Methode auf, um den Bezeichner einer Pin abzurufen.
[out] ppPin
Adresse einer Variablen, die einen Zeiger auf die IPin-Schnittstelle des Pins empfängt. Wenn die Methode fehlschlägt, wird *ppPin auf NULL festgelegt.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
NULL-Zeigerargument. |
|
Eine Pin mit diesem Bezeichner konnte nicht gefunden werden. |
Bemerkungen
Diese Methode unterstützt die Graphpersistenz. Verwenden Sie die IPin::QueryId-Methode , um den Status einer Pin zu speichern, und verwenden Sie diese Methode, um den Zustand wiederherzustellen. Die Bezeichnerzeichenfolge des Pins wird durch die Filterimplementierung definiert. Der Bezeichner muss innerhalb des Filters eindeutig sein.
Wenn die Methode erfolgreich ist, weist die zurückgegebene IPin-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie fertig sind.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |