Freigeben über


IMFRateSupport::GetFastestRate-Methode (mfidl.h)

Ruft die schnellste Wiedergaberate ab, die vom -Objekt unterstützt wird.

Syntax

HRESULT GetFastestRate(
  [in]  MFRATE_DIRECTION eDirection,
  [in]  BOOL             fThin,
  [out] float            *pflRate
);

Parameter

[in] eDirection

Gibt an, ob die schnellste Vorwärtswiedergaberate oder umgekehrte Wiedergaberate abfragt werden soll. Der Wert ist ein Member der MFRATE_DIRECTION-Enumeration .

[in] fThin

Wenn TRUE, ruft die Methode die schnellste verdünnte Wiedergaberate ab. Andernfalls ruft die -Methode die schnellste nicht verdünnte Wiedergaberate ab. Informationen zum Ausdünnen finden Sie unter Informationen zur Ratensteuerung.

[out] pflRate

Empfängt die schnellste Wiedergaberate, die das Objekt unterstützt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_REVERSE_UNSUPPORTED
Das -Objekt unterstützt keine umgekehrte Wiedergabe.
MF_E_THINNING_UNSUPPORTED
Das -Objekt unterstützt keine Ausdünnung.

Hinweise

Bei einigen Formaten (z. B. ASF) bedeutet das Ausdünnen, dass alle Frames gelöscht werden, die keine I-Frames sind. Wenn eine Komponente Datenstromdaten erzeugt, z. B. eine Medienquelle oder ein Demultiplexer, sollte sie auf den fThin-Parameter achten und MF_E_THINNING_UNSUPPORTED zurückgeben, wenn sie den Datenstrom nicht ausdünnen kann.

Wenn die Komponente einen Stream verarbeitet oder empfängt (die meisten Transformationen oder Mediensenken), kann sie diesen Parameter ignorieren, wenn es ihr egal ist, ob der Datenstrom ausgedünnt wird. Wenn die Transformationen bei der Implementierung der Ratenunterstützung der Mediensitzung nicht explizit die umgekehrte Wiedergabe unterstützen, versucht die Mediensitzung, die Wiedergabe umgekehrt mit Ausdünnung, aber nicht ohne Ausdünnung, wiederzugeben. Daher legen die meisten Anwendungen fThin auf TRUE fest, wenn die Mediensitzung für die Umgekehrte Wiedergabe verwendet wird.

Wenn eDirection MFRATE_REVERSE ist, ruft die Methode die schnellste Umgekehrte Wiedergaberate ab. Dies ist ein negativer Wert, sofern das Objekt die umgekehrte Wiedergabe unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

Ermitteln der unterstützten Raten

IMFRateSupport