waveOutGetPitch-Funktion (mmeapi.h)
Die waveOutGetPitch-Funktion ruft die aktuelle Tonhöheneinstellung für das angegebene Waveform-Audio-Ausgabegerät ab.
Syntax
MMRESULT waveOutGetPitch(
HWAVEOUT hwo,
LPDWORD pdwPitch
);
Parameter
hwo
Handle für das Waveform-Audio-Ausgabegerät.
pdwPitch
Zeiger auf eine Variable, die mit der aktuellen Einstellung des Pitch-Multiplikators gefüllt werden soll. Der Tonhöhenmultiplikator gibt die aktuelle Änderung der Tonhöhe gegenüber der ursprünglichen erstellten Einstellung an. Der Pitch-Multiplikator muss ein positiver Wert sein.
Der Multiplikator für die Tonhöhe 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 (keine Tonhöhenänderung) an, 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 |
|---|---|
|
Das angegebene Gerätehandle ist ungültig. |
|
Es ist kein Gerätetreiber vorhanden. |
|
Speicher kann nicht zugeordnet oder gesperrt werden. |
|
Die Funktion wird nicht unterstützt. |
Hinweise
Das Ändern der Tonhöhe ändert weder die Wiedergaberate noch die Abtastrate oder die Wiedergabezeit. Nicht alle Geräte unterstützen Tonhöhenänderungen. Um zu bestimmen, ob das Gerät die Pitch-Steuerung unterstützt, verwenden Sie das flag WAVECAPS_PITCH, um den dwSupport-Member der WAVEOUTCAPS-Struktur zu testen (gefüllt mit der waveOutGetDevCaps-Funktion ).
Anforderungen
| 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 |