Funzione auxGetVolume (mmeapi.h)
La funzione auxGetVolume recupera l'impostazione del volume corrente del dispositivo di output ausiliario specificato.
Sintassi
MMRESULT auxGetVolume(
UINT uDeviceID,
LPDWORD pdwVolume
);
Parametri
uDeviceID
Identificatore del dispositivo di output ausiliario su cui eseguire query.
pdwVolume
Puntatore a una variabile da riempire con l'impostazione del volume corrente. La parola in ordine basso di questa posizione contiene l'impostazione del volume del canale sinistro e la parola dell'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 del volume sinistro che destro, la parola di ordine inferiore della posizione specificata contiene il livello del volume.
Vengono restituite le impostazioni a 16 bit complete impostate con la funzione auxSetVolume , indipendentemente dal fatto che il dispositivo supporti l'intero controllo a livello di volume a 16 bit.
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 un 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 un dispositivo supporta il controllo volume sia nei canali sinistro che destro, usare il flag AUXCAPS_LRVOLUME per testare il membro dwSupport della struttura AUXCAPS (riempito da auxGetDevCaps).
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 |