CBaseFilter.FindPin-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 FindPin -Methode ruft den Pin mit dem angegebenen Bezeichner ab. Diese Methode implementiert die IBaseFilter::FindPin-Methode .
Syntax
HRESULT FindPin(
LPCWSTR Id,
IPin **ppPin
);
Parameter
-
Id
-
Zeiger auf eine konstante, NULL-beendete Unicode-Zeichenfolge, die den Pin identifiziert.
-
ppPin
-
Adresse einer Variablen, die einen Zeiger auf die IPin-Schnittstelle des Pins empfängt.
Rückgabewert
Gibt einen der folgenden HRESULT-Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
NULL-Zeigerargument. |
|
Es konnte kein passender Pin gefunden werden. |
Bemerkungen
Diese Methode ruft die CBasePin::Name-Methode auf, um den Namen der einzelnen Pins mit der im Id-Parameter angegebenen Zeichenfolge zu vergleichen.
Wenn die Methode erfolgreich ist, weist die IPin-Schnittstelle eine hervorragende Verweisanzahl auf. Stellen Sie sicher, dass Sie es freigeben, wenn Sie fertig sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|