Metodo IAudioSessionControl::GetGroupingParam (audiopolicy.h)

Il metodo GetGroupingParam recupera il parametro di raggruppamento della sessione audio.

Sintassi

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

Parametri

[out] pRetVal

Puntatore di output per il GUID del parametro di raggruppamento. Questo parametro deve essere un puntatore non NULL valido a una variabile GUID allocata dal chiamante. Il metodo scrive il parametro di raggruppamento in questa variabile.

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
E_POINTER
Il parametro pRetVal è NULL.
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.

Commenti

Tutte le sessioni audio con lo stesso valore del parametro di raggruppamento sono sotto il controllo dello stesso dispositivo di scorrimento a livello di volume nel programma di controllo del volume di sistema, Sndvol. Per altre informazioni, vedere Parametri di raggruppamento.

Un client può chiamare il metodo IAudioSessionControl::SetGroupingParam per modificare il parametro di raggruppamento di una sessione.

Se un client non ha mai chiamato SetGroupingParam per assegnare un parametro di raggruppamento a una sessione audio, il valore del parametro di raggruppamento della sessione è GUID_NULL per impostazione predefinita e una chiamata a GetGroupingParam recupera questo valore. Un valore del parametro di raggruppamento di GUID_NULL indica che la sessione non appartiene ad alcun raggruppamento. In tal caso, la sessione ha il proprio dispositivo di scorrimento a livello di volume nel programma Sndvol.

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

Vedi anche

Interfaccia IAudioSessionControl

IAudioSessionControl::SetGroupingParam