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
S_OK
Erfolg.
E_POINTER
NULL-Zeigerargument.
VFW_E_NOT_FOUND
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

Siehe auch

Fehler- und Erfolgscodes

IBaseFilter-Schnittstelle