Share via


Metodo ISimpleAudioVolume::GetMasterVolume (audioclient.h)

Il metodo GetMasterVolume recupera il livello del volume client per la sessione audio.

Sintassi

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Parametri

[out] pfLevel

Puntatore a una variabile float in cui il metodo scrive il livello del volume client. Il livello del volume è un valore nell'intervallo da 0,0 a 1,0.

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_POINTER
Il parametro pfLevel è NULL.
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 recupera il livello del volume client per la sessione. Si tratta del livello di volume impostato dal client in una chiamata precedente al metodo ISimpleAudioVolume::SetMasterVolume .

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

IAudioClient::Initialize

Interfaccia ISimpleAudioVolume

ISimpleAudioVolume::SetMasterVolume