Share via

Funzione midiOutGetVolume (mmeapi.h)

  • Articolo

La funzione midiOutGetVolume recupera l'impostazione del volume corrente di un dispositivo di output MIDI.

Sintassi

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Parametri

hmo

Gestire in un dispositivo di output MIDI aperto. Questo parametro può anche contenere l'handle di un flusso MIDI, purché venga eseguito il cast a HMIDIOUT. Questo parametro può anche essere un identificatore del dispositivo.

pdwVolume

Puntatore alla posizione in cui contenere l'impostazione del volume corrente. La parola in ordine basso di questa posizione contiene l'impostazione del volume del canale sinistro e la parola di 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 in ordine basso della posizione specificata contiene il livello del volume mono.

Qualsiasi valore impostato usando la funzione midiOutSetVolume viene restituito, indipendentemente dal fatto che il dispositivo supporti tale valore.

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_INVALHANDLE
 L'handle del dispositivo specificato non è valido.
MMSYSERR_INVALPARAM
 Il puntatore o la struttura specificati non sono validi.
MMSYSERR_NOMEM
 Il sistema non è in grado di allocare o bloccare la memoria.
MMSYSERR_NOTSUPPORTED
 La funzione non è supportata.

Commenti

Se viene usato un identificatore di dispositivo, il risultato della chiamata midiOutGetVolume e le informazioni restituite in lpdwVolume 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 il controllo del volume. È possibile determinare se un dispositivo supporta il controllo del volume eseguendo una query sul dispositivo usando la funzione midiOutGetDevCaps e specificando il flag MIDICAPS_VOLUME.

È anche possibile determinare se il dispositivo supporta il controllo del volume nei canali sinistro e destro eseguendo una query sul dispositivo usando la funzione midiOutGetDevCaps e specificando il flag MIDICAPS_LRVOLUME.

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

Funzioni MIDI