Funzione auxSetVolume (mmeapi.h)

La funzione auxSetVolume imposta il volume del dispositivo di output ausiliario specificato.

Sintassi

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

Parametri

uDeviceID

Identificatore del dispositivo di output ausiliario su cui eseguire query. Gli identificatori di dispositivo vengono determinati in modo implicito dal numero di dispositivi presenti nel sistema. I valori dell'identificatore del dispositivo sono compresi tra zero e uno minore del numero di dispositivi presenti. Usare la funzione auxGetNumDevs per determinare il numero di dispositivi ausiliari nel sistema.

dwVolume

Specifica la nuova impostazione del volume. La parola di ordine basso specifica l'impostazione del volume del canale sinistro e la parola di ordine elevato specifica l'impostazione del canale destro. Un valore di 0xFFFF rappresenta il volume completo e un valore di 0x0000 è silenzio.

Se un dispositivo non supporta sia il controllo volume sinistro che destro, la parola dwVolume in ordine basso specifica il livello del volume e la parola di ordine elevato viene ignorata.

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
MMSYSERR_BADDEVICEID	L'identificatore del dispositivo specificato non è compreso nell'intervallo.

Commenti

Non tutti i dispositivi supportano il controllo del volume. Per determinare se il dispositivo supporta il controllo volume, usare il flag AUXCAPS_VOLUME per testare il membro dwSupport della struttura AUXCAPS (riempito dalla funzione auxGetDevCaps ).

Per determinare se il dispositivo supporta il controllo del volume sia nei canali sinistro che destro, usare il flag AUXCAPS_LRVOLUME per testare il membro dwSupport della struttura AUXCAPS (riempito da auxGetDevCaps).

La maggior parte dei dispositivi non supporta i 16 bit completi del controllo a livello di volume e userà solo i bit di ordine elevato dell'impostazione del volume richiesto. Ad esempio, per un dispositivo che supporta 4 bit di controllo volume, i valori del livello di volume richiesti di 0x4000, 0x4FFF e 0x43BE produrranno la stessa impostazione del volume fisico, 0x4000. La funzione auxGetVolume restituirà l'impostazione a 16 bit completa impostata con auxSetVolume.

Le impostazioni del volume vengono interpretate in modo logaritmico. Ciò significa che l'aumento del volume percepito è lo stesso quando si aumenta il livello di volume da 0x5000 a 0x6000 così come è da 0x4000 a 0x5000.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmeapi.h (include Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform