waveOutSetPitch-Funktion (mmeapi.h)
Die waveOutSetPitch-Funktion legt die Tonhöhe für das angegebene Signalform-Audioausgabegerät fest.
Syntax
MMRESULT waveOutSetPitch(
HWAVEOUT hwo,
DWORD dwPitch
);
Parameter
hwo
Handle mit dem Waveform-Audioausgabegerät.
dwPitch
Neue Pitch-Multiplikatoreinstellung. Diese Einstellung gibt die aktuelle Änderung der Tonhöhe gegenüber der ursprünglich erstellten Einstellung an. Der Pitchmultiplikator muss ein positiver Wert sein.
Der Pitch-Multiplikator wird als Fixpunktwert angegeben. Das Wort mit hoher Reihenfolge enthält den ganzzahligen Teil der Zahl mit Vorzeichen, und das Wort mit niedriger Reihenfolge enthält den Bruchteil. Ein Wert von 0x8000 im Wort mit niedriger Reihenfolge stellt die Hälfte dar, und 0x4000 stellt ein Viertel dar. Beispielsweise gibt der Wert 0x00010000 einen Multiplikator von 1,0 an (keine Tonhöhenänderung), und ein Wert von 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, noch die Wiedergabezeit. Nicht alle Geräte unterstützen Pitchänderungen. Um zu bestimmen, ob das Gerät das Pitch-Steuerelement unterstützt, verwenden Sie das flag WAVECAPS_PITCH, um das dwSupport-Element 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ßlich Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |