Metodo IAudioSessionManager::GetSimpleAudioVolume (audiopolicy.h)

Articolo
02/23/2024

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.

Codice restituito	Descrizione
AUDCLNT_E_NOT_INITIALIZED	Il flusso audio non è stato inizializzato correttamente.
AUDCLNT_E_DEVICE_INVALIDATED	Il dispositivo endpoint audio è stato scollegato oppure 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.
E_POINTER	Il parametro AudioVolume è NULL.
E_MEMORY	Memoria insufficiente.

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

Vedi anche

Interfaccia IAudioSessionManager

Interfaccia ISimpleAudioVolume

Condividi tramite