Metodo IPerChannelDbLevel::SetLevelUniform (devicetopology.h)

Il metodo SetLevelUniform imposta tutti i canali nel flusso audio allo stesso livello di volume uniforme, in decibel.

Sintassi

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parametri

[in] fLevelDB

Nuovo livello uniforme in decibel.

[in] pguidEventContext

Valore di contesto per il metodo IControlChangeNotify::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetLevelUniform 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_OUTOFMEMORY	Memoria insufficiente.

Commenti

Se il livello uniforme specificato supera l'intervallo indicato dal metodo IPerChannelDbLevel::GetLevelRange per un determinato canale, la chiamata SetLevelUniform blocca il valore per tale canale nell'intervallo supportato e completa correttamente. Una chiamata successiva al metodo IPerChannelDbLevel::GetLevel recupera il valore effettivo usato per tale canale.

Requisiti

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::GetLevel

IPerChannelDbLevel::GetLevelRange