Metodo IBasicAudio::p ut_Volume (control.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il put_Volume metodo imposta il volume (ampiezza) del segnale audio.
Sintassi
HRESULT put_Volume(
[in] long lVolume
);
Parametri
[in] lVolume
Specifica il volume, come numero compreso tra -10.000 e 0. Il volume completo è 0 e -10.000 è silenzio. Moltiplicare il livello decibel desiderato per 100. Ad esempio, –10.000 = -100 dB.
Valore restituito
Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Il dispositivo audio sottostante ha restituito un errore. |
|
Il valore di lVolume non è valido. |
|
Il grafico del filtro non contiene un filtro del renderer audio. (Possibilmente l'origine non contiene un flusso audio. |
|
Operazione completata. |
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 | control.h (include Dshow.h) |
| Libreria | Strmiids.lib |