Freigeben über


auxSetVolume-Funktion (mmeapi.h)

Die auxSetVolume-Funktion legt das Volumen des angegebenen Hilfsausgabegeräts fest.

Syntax

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

Parameter

uDeviceID

Bezeichner des abgefragten Hilfsausgabegeräts. Gerätebezeichner werden implizit aus der Anzahl der im System vorhandenen Geräte bestimmt. Gerätebezeichnerwerte reichen von null bis eins kleiner als die Anzahl der vorhandenen Geräte. Verwenden Sie die auxGetNumDevs-Funktion , um die Anzahl der Hilfsgeräte im System zu bestimmen.

dwVolume

Gibt die neue Volumeeinstellung an. Das Wort mit niedriger Reihenfolge gibt die Lautstärkeeinstellung für den linken Kanal an, und das Wort mit hoher Ordnung gibt die Einstellung für den rechten Kanal an. Ein Wert von 0xFFFF stellt die volle Lautstärke dar, und der Wert 0x0000 ist Stille.

Wenn ein Gerät die Linke und die rechte Lautstärkeregelung nicht unterstützt, gibt das Wort mit niedriger Reihenfolge dwVolume die Lautstärkeebene an, und das Wort mit hoher Ordnung wird ignoriert.

Rückgabewert

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

Rückgabecode Beschreibung
MMSYSERR_BADDEVICEID
Der angegebene Gerätebezeichner liegt außerhalb des Bereichs.

Hinweise

Nicht alle Geräte unterstützen die Lautstärkeregelung. Um zu bestimmen, ob das Gerät die Lautstärkeregelung unterstützt, verwenden Sie das flag AUXCAPS_VOLUME, um den dwSupport-Member der AUXCAPS-Struktur zu testen (gefüllt mit der auxGetDevCaps-Funktion ).

Um zu bestimmen, ob das Gerät die Lautstärkesteuerung sowohl auf dem linken als auch im rechten Kanal unterstützt, verwenden Sie das flag AUXCAPS_LRVOLUME, um den dwSupport-Member der AUXCAPS-Struktur (gefüllt mit auxGetDevCaps) zu testen.

Die meisten Geräte unterstützen nicht die vollständige 16-Bit-Steuerung auf Volumeebene und verwenden nur die Bits mit hoher Reihenfolge der angeforderten Volumeeinstellung. Für ein Gerät, das z. B. 4 Bits der Lautstärkesteuerung unterstützt, erzeugen die angeforderten Volumeebenenwerte von 0x4000, 0x4FFF und 0x43BE die gleiche Physische Volumeeinstellung, 0x4000. Die auxGetVolume-Funktion gibt die vollständige 16-Bit-Einstellung zurück, die mit auxSetVolume festgelegt ist.

Volumeeinstellungen werden logarithmisch interpretiert. Dies bedeutet, dass die wahrgenommene Volumenerhöhung beim Erhöhen der Lautstärke von 0x5000 auf 0x6000 gleich ist, wie von 0x4000 auf 0x5000.

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