CEnumPins.Next-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 Next-Methode ruft eine angegebene Anzahl von Pins in der Enumerationssequenz ab. Diese Methode implementiert die IEnumPins::Next-Methode .
Syntax
HRESULT Next(
ULONG cPins,
IPin **ppPins,
ULONG *pcFetched
);
Parameter
-
cPins
-
Anzahl der abzurufenden Pins.
-
ppPins
-
Array von Größen-CPins , das mit IPin-Zeigern gefüllt ist.
-
pcFetched
-
Zeiger auf eine Variable, die die Anzahl der abgerufenen Pins empfängt. Kann NULL sein, wenn cPins 1 ist.
Rückgabewert
Gibt einen der in der folgenden Tabelle gezeigten HRESULT-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Es wurden nicht so viele Pins abgerufen, wie angefordert. |
|
Erfolg. |
|
Ungültiges Argument. |
|
NULL-Zeigerargument. |
|
Der Status des Filters hat sich geändert und ist jetzt mit dem Enumerator inkonsistent. |
Bemerkungen
Diese Methode ruft Zeiger auf die angegebene Anzahl von Pins ab der aktuellen Position in der Enumeration ab und platziert sie im angegebenen Array.
Diese Methode ruft die CBaseFilter::GetPin-Methode des Filters auf, um die Pins abzurufen.
Wenn die Methode erfolgreich ist, weisen alle IPin-Zeiger ausstehende Verweisanzahlen auf. Stellen Sie sicher, dass Sie sie freigeben, wenn Sie fertig sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|