IEnumMediaTypes::Skip-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 Skip -Methode überspringt eine angegebene Anzahl von Medientypen.

Syntax

HRESULT Skip(
  [in] ULONG cMediaTypes
);

Parameter

[in] cMediaTypes

Anzahl der zu überspringenden Medientypen.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	Beschreibung
S_FALSE	Übersprungen am Ende der Sequenz.
S_OK	Erfolg.
VFW_E_ENUM_OUT_OF_SYNC	Der Status des Pins hat sich geändert und ist jetzt mit dem Enumerator inkonsistent.

Hinweise

Wenn sich der Satz von Medientypen ändert, ist der Enumerator nicht mehr mit dem Pin 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 IEnumMediaTypes::Reset-Methode aufrufen. Anschließend können Sie die Skip -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

Auflisten von Medientypen

Fehler- und Erfolgscodes

IEnumMediaTypes-Schnittstelle