Condividi tramite


Metodo IAudioEndpointVolume::SetChannelVolumeLevelScalar (endpointvolume.h)

Il metodo SetChannelVolumeLevelScalar imposta il livello di volume normalizzato e con tocco audio del canale specificato nel flusso audio che entra o lascia il dispositivo dell'endpoint audio.

Sintassi

HRESULT SetChannelVolumeLevelScalar(
  [in] UINT    nChannel,
  [in] float   fLevel,
  [in] LPCGUID pguidEventContext
);

Parametri

[in] nChannel

Numero di canale. Se il flusso audio contiene n canali, i canali vengono numerati da 0 a n- 1. Per ottenere il numero di canali, chiamare il metodo IAudioEndpointVolume::GetChannelCount .

[in] fLevel

Livello del volume. Il livello del volume viene espresso come valore normalizzato nell'intervallo compreso tra 0,0 e 1,0.

[in] pguidEventContext

Valore di contesto per il metodo IAudioEndpointVolumeCallback::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetChannelVolumeLevelScalar modifica il livello di volume dell'endpoint, tutti i client che hanno registrato interfacce IAudioEndpointVolumeCallback con tale endpoint riceveranno notifiche. Nell'implementazione del metodo OnNotify , un client può controllare il GUID del contesto evento per individuare se è l'origine dell'evento di modifica del volume o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, la routine di notifica riceve il valore GUID di contesto GUID_NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se il metodo ha esito negativo, i possibili codici restituiti includono, ma non sono limitati a, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_INVALIDARG
Il parametro nChannel è maggiore o uguale al numero di canali nel flusso; o il parametro fLevel non è compreso nell'intervallo compreso tra 0,0 e 1.0.
E_OUTOFMEMORY
Memoria insufficiente.

Commenti

Il livello del volume è normalizzato all'intervallo compreso tra 0,0 e 1,0, dove 0,0 è il livello minimo del volume e 1.0 è il livello massimo. All'interno di questo intervallo, la relazione del livello di volume normalizzato all'attenuazione dell'ampiezza del segnale è descritta da una curva non lineare, audio-tapered. Si noti che la forma della curva potrebbe cambiare nelle versioni future di Windows. Per altre informazioni sulle curve con taper audio, vedere Controlli volume con tocco audio.

I livelli di volume normalizzati passati a questo metodo sono adatti per rappresentare le posizioni dei controlli del volume nelle finestre dell'applicazione e nella schermata.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione endpointvolume.h

Vedi anche

Interfaccia IAudioEndpointVolume

IAudioEndpointVolume::GetChannelCount

Interfaccia IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify