Funzione midiOutGetVolume (mmeapi.h)
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 |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
Il puntatore o la struttura specificati non sono validi. |
|
Il sistema non è in grado di allocare o bloccare la memoria. |
|
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 |