Metodo ISimpleAudioVolume::SetMasterVolume (audioclient.h)

Articolo
02/23/2024

Il metodo SetMasterVolume imposta il livello del volume master per la sessione audio.

Sintassi

HRESULT SetMasterVolume(
  [in] float   fLevel,
  [in] LPCGUID EventContext
);

Parametri

[in] fLevel

Nuovo livello di volume master. I livelli di volume validi si trovano nell'intervallo da 0,0 a 1,0.

[in] EventContext

Puntatore al GUID del contesto evento. Se una chiamata a questo metodo genera un evento di modifica del volume, la gestione sessione invia notifiche a tutti i client che hanno registrato interfacce IAudioSessionEvents con la gestione sessione. Gestione sessione include il valore del puntatore EventContext con ogni notifica. Dopo aver ricevuto una notifica, un client può determinare se è l'origine dell'evento o un altro client controllando il valore EventContext . Questo schema dipende dal client che seleziona un valore per questo parametro univoco tra tutti i client della sessione. 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 fLevel non è compreso nell'intervallo da 0.0 a 1.0.
AUDCLNT_E_DEVICE_INVALIDATED	Il dispositivo endpoint audio è stato scollegato o l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso.
AUDCLNT_E_SERVICE_NOT_RUNNING	Il servizio audio Di Windows non è in esecuzione.

Commenti

Questo metodo genera un evento di modifica del volume solo se la chiamata al metodo modifica il livello del volume della sessione. Ad esempio, se il livello del volume è 0,4 quando si verifica la chiamata e la chiamata imposta il livello del volume su 0,4, non viene generato alcun evento.

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	audioclient.h

Vedi anche

Interfaccia IAudioSessionEvents

Interfaccia ISimpleAudioVolume

ISimpleAudioVolume::GetMasterVolume

Condividi tramite