Metodo IAudioSessionManager::GetSimpleAudioVolume (audiopolicy.h)

Il metodo GetSimpleAudioVolume recupera un semplice controllo volume audio.

Sintassi

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

Parametri

[in] AudioSessionGuid

Puntatore a un GUID di sessione. Se il GUID non identifica una sessione aperta in precedenza, la chiamata apre una nuova sessione ma vuota. Il programma Sndvol non visualizza un controllo a livello di volume per una sessione, a meno che non contenga uno o più flussi attivi. Se questo parametro è NULL o punta al valore GUID_NULL, il metodo assegna il flusso alla sessione predefinita.

[in] StreamFlags

Specifica se la richiesta è per una sessione tra processi. Impostare su TRUE se la sessione è interprocesso. Impostare su FALSE se la sessione non è interprocesso.

[out] AudioVolume

Puntatore a una variabile puntatore in cui il metodo scrive un puntatore nell'interfaccia ISimpleAudioVolume dell'oggetto controllo volume audio. Questa interfaccia rappresenta il semplice controllo volume audio per il processo corrente. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata Activate ha esito negativo, *AudioVolume è NULL.

Valore restituito

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

Requisiti

Vedi anche

Interfaccia IAudioSessionManager

Interfaccia ISimpleAudioVolume