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
MMSYSERR_INVALHANDLE	L'handle del dispositivo specificato non è valido.
MMSYSERR_NODRIVER	Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM	Impossibile allocare o bloccare la memoria.
MMSYSERR_NOTSUPPORTED	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

Vedi anche

Waveform Audio

Funzioni waveform