waveOutGetPlaybackRate-Funktion (mmeapi.h)

  • Artikel

Die waveOutGetPlaybackRate-Funktion ruft die aktuelle Wiedergaberate für das angegebene Waveform-Audioausgabegerät ab.

Syntax

MMRESULT waveOutGetPlaybackRate(
  HWAVEOUT hwo,
  LPDWORD  pdwRate
);

Parameter

hwo

Handle für das Waveform-Audio-Ausgabegerät.

pdwRate

Zeiger auf eine Variable, die mit der aktuellen Wiedergaberate gefüllt werden soll. Die Einstellung für die Wiedergaberate ist ein Multiplikator, der die aktuelle Änderung der Wiedergaberate gegenüber der ursprünglichen erstellten Einstellung angibt. Der Multiplikator für die Wiedergaberate muss ein positiver Wert sein.

Die Rate wird als Festpunktwert angegeben. Das Wort mit hoher Reihenfolge der Variablen enthält den ganzzahligen Teil der Zahl mit Vorzeichen, und das Wort mit niedriger Ordnung enthält den Teilbruch. Der Wert 0x8000 im Wort mit niedriger Ordnung stellt die hälfte und 0x4000 ein Viertel dar. Beispielsweise gibt der Wert 0x00010000 einen Multiplikator von 1,0 an (keine Änderung der Wiedergaberate), und der Wert 0x000F8000 gibt einen Multiplikator von 15,5 an.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMSYSERR_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.
MMSYSERR_NODRIVER
 Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM
 Speicher kann nicht zugeordnet oder gesperrt werden.
MMSYSERR_NOTSUPPORTED
 Die Funktion wird nicht unterstützt.

Hinweise

Das Ändern der Wiedergaberate ändert nicht die Abtastrate, sondern die Wiedergabezeit. Nicht alle Geräte unterstützen Änderungen der Wiedergaberate. Um zu bestimmen, ob ein Gerät Änderungen an der Wiedergaberate unterstützt, verwenden Sie das flag WAVECAPS_PLAYBACKRATE, um den dwSupport-Member der WAVEOUTCAPS-Struktur zu testen (gefüllt mit der waveOutGetDevCaps-Funktion ).

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 mmeapi.h (Einschließen von Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Waveform-Audio

Wellenformfunktionen