IMediaPosition::p ut_Rate-Methode (control.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 put_Rate-Methode legt die Wiedergaberate fest.

Syntax

HRESULT put_Rate(
  [in] double dRate
);

Parameter

[in] dRate

Wiedergaberate. Darf nicht null sein.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
E_NOTIMPL	Nicht implementiert.

Bemerkungen

Die Wiedergaberate wird als Verhältnis der normalen Geschwindigkeit ausgedrückt. Daher ist 1.0 die normale Wiedergabegeschwindigkeit, 0,5 ist die halbe Geschwindigkeit und 2.0 ist doppelt so schnell. Bei Audiostreams ändert sich durch das Ändern der Rate auch die Tonhöhe.

Weitere Informationen finden Sie in den Hinweisen in IMediaSeeking::SetRate.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	control.h (include Dshow.h)
Bibliothek	Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IMediaPosition-Schnittstelle