Funzione auxGetVolume (mmeapi.h)

Articolo
03/15/2023

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

Vedi anche

Waveform Audio

Funzioni waveform

Share via