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