Metodo IPerChannelDbLevel::SetLevel (devicetopology.h)

Articolo
08/23/2023

Il metodo SetLevel imposta il livello del volume, in decibel, del canale specificato.

Sintassi

HRESULT SetLevel(
  [in] UINT    nChannel,
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parametri

[in] nChannel

Numero del canale selezionato. Se il flusso audio ha canali N , i canali vengono numerati da 0 a N- 1. Per ottenere il numero di canali nel flusso, chiamare il metodo IPerChannelDbLevel::GetChannelCount .

[in] fLevelDB

Nuovo livello di volume in decibel. Un valore positivo rappresenta il guadagno e un valore negativo rappresenta l'attenuazione.

[in] pguidEventContext

Valore di contesto per il metodo IControlChangeNotify::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetLevel modifica lo stato del controllo a livello, tutti i client che hanno registrato interfacce IControlChangeNotify con tale controllo ricevono notifiche. Nell'implementazione del metodo OnNotify , un client può esaminare il GUID del contesto evento per individuare se è l'origine dell'evento control-change o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .

Valore restituito

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

Codice restituito	Descrizione
E_INVALIDARG	Il parametro nChannel non è compreso nell'intervallo.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Se il chiamante specifica un valore per fLevelDB che è un valore di passaggio esatto, il metodo SetLevel viene completato correttamente. Una chiamata successiva al metodo IPerChannelDbLevel::GetLevel restituirà il valore impostato o uno dei valori seguenti:

Se il valore impostato è inferiore al minimo, il metodo GetLevel restituisce il valore minimo.
Se il valore impostato è superiore al massimo, il metodo GetLevel restituisce il valore massimo.
Se il valore impostato è stato compreso tra due valori di passaggio, il metodo GetLevel restituisce un valore che potrebbe essere il valore di passaggio successivo sopra o il valore di passaggio inferiore al valore impostato; le distanze relative dal valore impostato ai valori di esecuzione adiacenti non sono importanti. Il valore restituito dal metodo GetLevel è il valore che ha un impatto maggiore sul percorso del segnale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IPerChannelDbLevel

IPerChannelDbLevel::GetChannelCount

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange

Condividi tramite