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
| Wert | BESCHREIBUNG |
|---|---|
| S_FALSE | Es wurden nicht so viele Filter wie angefordert abgerufen. |
| S_OK | Erfolg. |
| E_INVALIDARG | Ungültiges Argument. |
| E_POINTER | NULL-Zeigerargument. |
| VFW_E_ENUM_OUT_OF_SYNC | Das Diagramm hat sich geändert und ist jetzt mit dem Enumerator inkonsistent. |
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
| 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 |