IAMVideoCompression::get_KeyFrameRate-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 get_KeyFrameRate -Methode ruft die aktuelle Key-Frame-Rate ab.

Syntax

HRESULT get_KeyFrameRate(
  [out] long *pKeyFrameRate
);

Parameter

[out] pKeyFrameRate

Zeiger auf eine Variable, die die aktuelle Key-Frame-Rate empfängt. Wenn der Wert negativ ist, verwendet der Filter die Standardmäßige Key-Frame-Rate. Wenn der Wert 0 ist, ist nur der erste Frame ein Keyframe.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Die Keyframerate ist die Anzahl der Frames pro Keyframe. Wenn die Rate beispielsweise 15 beträgt, tritt alle 15 Frames ein Keyframe auf.

Um festzustellen, ob der Filter diese Methode unterstützt, rufen Sie die IAMVideoCompression::GetInfo-Methode auf, und suchen Sie im pCapabilities-Parameter nach dem flag CompressionCaps_CanKeyFrame. Die GetInfo-Methode gibt auch die Standardmäßige Key-Frame-Rate zurück.

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

IAMVideoCompression::p ut_KeyFrameRate