IMFPMediaPlayer::SetRate-Methode (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.

 

Legt die Wiedergaberate fest.

Syntax

HRESULT SetRate(
  [in] float flRate
);

Parameter

[in] flRate

Wiedergaberate. Die Wiedergaberate wird als Verhältnis der aktuellen Rate zur normalen Rate ausgedrückt. Beispielsweise gibt 1.0 die normale Wiedergabegeschwindigkeit an, 0,5 die halbe Geschwindigkeit und 2.0 die doppelte Geschwindigkeit. Positive Werte geben die Vorwärtswiedergabe an, negative Werte für die umgekehrte Wiedergabe.

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_OUT_OF_RANGE	Der flRate-Parameter ist 0 (null).
MF_E_SHUTDOWN	Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Diese Methode wird asynchron abgeschlossen. Nach Abschluss des Vorgangs wird die IMFPMediaPlayerCallback::OnMediaPlayerEvent-Rückrufmethode der Anwendung aufgerufen. Der Ereignistyp ist MFP_EVENT_TYPE_RATE_SET.

Die -Methode legt die nächste unterstützte Rate fest, die von der zugrunde liegenden Medienquelle abhängt. Wenn flRate beispielsweise 50 und die maximale Rate der Quelle 8× Normalrate ist, legt die Methode die Rate auf 8,0 fest. Die tatsächliche Rate wird in den Ereignisdaten für das MFP_EVENT_TYPE_RATE_SET-Ereignis angegeben.

Rufen Sie IMFPMediaPlayer::GetSupportedRates auf, um den Bereich der unterstützten Raten zu ermitteln.

Diese Methode unterstützt keine Wiedergaberaten von null, obwohl Media Foundation in einigen anderen Kontexten eine Bedeutung für Nullraten definiert.

Der neue Tarif gilt nur für das aktuelle Medienelement. Durch festlegen eines neuen Medienelements wird die Wiedergaberate auf 1,0 zurückgesetzt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfplay.h

Weitere Informationen

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe