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 |
|---|---|
|
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 |