CEnumPins.Next-Methode

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 der Größe 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
S _ FALSE
Es wurden nicht so viele Pins wie angefordert abgerufen.
S _ OK
Erfolg.
E _ INVALIDARG
Ungültiges Argument.
E _ POINTER
NULL-Zeigerargument.
VFW _ E _ ENUM _ OUT _ OF _ SYNC
Der Status des Filters hat sich geändert und ist nun mit dem Enumerator inkonsistent.

Hinweise

Diese Methode ruft Zeiger auf die angegebene Anzahl von Pins ab, beginnend an der aktuellen Position in der Enumeration, 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, verfügen alle IPin-Zeiger über ausstehende Verweisanzahlen. Stellen Sie sicher, dass Sie sie freigeben, wenn Sie fertig sind.

Anforderungen

Anforderung Wert
Header
Amfilter.h (include Streams.h)
Bibliothek
Strmbase.lib (Verkaufsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CEnumPins-Klasse