IEnumFilters::Next-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 Next -Methode ruft die angegebene Anzahl von Filtern in der Enumerationssequenz ab.

Syntax

HRESULT Next(
  [in]  ULONG       cFilters,
  [out] IBaseFilter **ppFilter,
  [out] ULONG       *pcFetched
);

Parameter

[in] cFilters

Anzahl der abzurufenden Filter.

[out] ppFilter

Array von cFiltern der Größe, das mit IBaseFilter-Schnittstellenzeigern gefüllt ist. Der Aufrufer muss die Schnittstellen freigeben.

[out] pcFetched

Empfängt die Anzahl der abgerufenen Filter. Kann NULL sein, wenn cFilters den Wert 1 aufweist.

Rückgabewert

Hinweise

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

Wenn sich das Filterdiagramm ändert (z. B. entfernt die Anwendung einen Filter), ist der Enumerator nicht mehr mit dem Diagramm 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 IEnumFilters::Reset-Methode aufrufen. Anschließend können Sie die Next -Methode sicher aufrufen.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IEnumFilters-Schnittstelle