funzione waveOutGetVolume (mmeapi.h)
La funzione waveOutGetVolume recupera il livello di volume corrente del dispositivo di output waveform-audio specificato.
Sintassi
MMRESULT waveOutGetVolume(
HWAVEOUT hwo,
LPDWORD pdwVolume
);
Parametri
hwo
Gestire un dispositivo di output waveform-audio aperto. Questo parametro può anche essere un identificatore del dispositivo.
pdwVolume
Puntatore a una variabile da riempire con l'impostazione del volume corrente. La parola a basso ordine di questa posizione contiene l'impostazione del volume del canale sinistro e la parola con ordine elevato contiene 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 a basso ordine della posizione specificata contiene il livello di volume mono.
Le impostazioni a 16 bit complete impostate con la funzione waveOutSetVolume vengono restituite , indipendentemente dal fatto che il dispositivo supporti i 16 bit completi del controllo a livello di volume.
Valore restituito
Restituisce MMSYSERR_NOERROR se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
Non è presente alcun driver di dispositivo. |
|
Impossibile allocare o bloccare la memoria. |
|
La funzione non è supportata. |
Commenti
Se viene usato un identificatore di dispositivo, il risultato della chiamata waveOutGetVolume e le informazioni restituite in pdwVolume si applicano a tutte le istanze del dispositivo. Se viene usato un handle di dispositivo, il risultato e le informazioni restituite si applicano solo all'istanza del dispositivo a cui fa riferimento l'handle del dispositivo.
Non tutti i dispositivi supportano le modifiche al volume. Per determinare se il dispositivo supporta il controllo del volume, usare il flag WAVECAPS_VOLUME per testare il membro dwSupport della struttura WAVEOUTCAPS (riempito dalla funzione waveOutGetDevCaps ).
Per determinare se il dispositivo supporta il controllo del volume a sinistra e destro, usare il flag di WAVECAPS_LRVOLUME per testare il membro dwSupport della struttura WAVEOUTCAPS (riempito da waveOutGetDevCaps).
Le impostazioni del volume vengono interpretate in modo logaritmico. Ciò significa che l'aumento percepito del volume è lo stesso quando si aumenta il livello di volume da 0x5000 a 0x6000 così come è da 0x4000 a 0x5000.
Requisiti
| 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 (includere Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |