IAMVideoCompression::OverrideKeyFrame-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die OverrideKeyFrame -Methode weist den Filter an, einen bestimmten Frame als Keyframe zu komprimieren.

Syntax

HRESULT OverrideKeyFrame(
  [in] long FrameNumber
);

Parameter

[in] FrameNumber

Gibt die Framenummer an. Der erste Frame, den der Filter liefert, ist nummeriert 0.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_NOTIMPL	Nicht implementiert.

Hinweise

Wenn der Filter diese Methode unterstützt, können Sie sie verwenden, um die normale Keyframeverteilung für einen bestimmten Frame zu überschreiben. Nachdem der Filter einen Schlüsselrahmen erstellt hat, kann er seine Anzahl zurücksetzen, um zu bestimmen, wann der nächste Keyframe auftreten soll. Wenn die Key-Frame-Rate beispielsweise 10 ist und eine Anwendung diese Methode verwendet, um Frame 5 als Schlüsselbild zu erzwingen, wartet der Filter möglicherweise weitere 10 Frames (bis Frame 15), bevor er den nächsten Schlüsselrahmen erstellt.

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

IAMVideoCompression-Schnittstelle