Metodo IAudioSessionManager::GetAudioSessionControl (audiopolicy.h)

  • Articolo

Il metodo GetAudioSessionControl recupera un controllo sessione audio.

Sintassi

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

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 lo stato dei flag per il flusso audio.

[out] SessionControl

Puntatore a una variabile puntatore in cui il metodo scrive un puntatore all'interfaccia IAudioSessionControl dell'oggetto controllo sessione audio. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata ha esito negativo, *SessionControl è 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
AUDCLNT_E_NOT_INITIALIZED
 Il flusso audio non è stato inizializzato correttamente.
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.
E_POINTER
 SessionControl del parametro è NULL.
E_MEMORY
 Memoria insufficiente.

Commenti

Per un esempio di codice che chiama questo metodo, vedere Eventi audio per applicazioni audio legacy.

Requisiti

   
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 IAudioSessionControl

Interfaccia IAudioSessionManager