Freigeben über

IEnumPins::Next-Methode (strmif.h)

  • Artikel

[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.

Syntax

HRESULT Next(
  [in]  ULONG cPins,
  [out] IPin  **ppPins,
  [out] ULONG *pcFetched
);

Parameter

[in] cPins

Anzahl der abzurufenden Pins.

[out] ppPins

Array von Größen-CPins , das mit IPin-Zeigern gefüllt ist. Der Aufrufer muss die Schnittstellen freigeben.

[out] 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 folgenden HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_FALSE
 Es wurden nicht so viele Pins abgerufen, wie angefordert.
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 jetzt mit dem Enumerator inkonsistent.

Hinweise

Diese Methode ruft Zeiger auf die angegebene Anzahl von Pins ab der aktuellen Position in der Enumeration ab und platziert sie im angegebenen Array.

Wenn die Methode erfolgreich ist, weisen alle IPin-Zeiger ausstehende Verweisanzahlen auf. Stellen Sie sicher, dass Sie sie freigeben, wenn Sie fertig sind.

Wenn sich die Anzahl der Pins ändert, ist der Enumerator nicht mehr mit dem Filter konsistent, und die Methode gibt VFW_E_ENUM_OUT_OF_SYNC zurück. Verwerfen Sie alle Daten, die von vorherigen Aufrufen des Enumerators abgerufen wurden, da sie möglicherweise ungültig sind. Aktualisieren Sie den Enumerator, indem Sie die IEnumPins::Reset-Methode aufrufen. Anschließend können Sie die Next -Methode sicher aufrufen.

Anforderungen

Anforderung Wert
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

Weitere Informationen

Fehler- und Erfolgscodes

IEnumPins-Schnittstelle