Metodo IAudioSessionControl::SetGroupingParam (audiopolicy.h)
Il metodo SetGroupingParam assegna una sessione a un raggruppamento di sessioni.
Sintassi
HRESULT SetGroupingParam(
[in] LPCGUID Override,
[in] LPCGUID EventContext
);
Parametri
[in] Override
Nuovo parametro di raggruppamento. Questo parametro deve essere un puntatore non NULL valido a un GUID del parametro di raggruppamento. Per altre informazioni, vedere la sezione Osservazioni.
[in] EventContext
Puntatore al GUID del contesto dell'evento. Se una chiamata a questo metodo genera un evento di modifica del raggruppamento, il gestore sessione invia notifiche a tutti i client che hanno registrato interfacce IAudioSessionEvents con il gestore sessione. La gestione sessione include il valore del puntatore EventContext con ogni notifica. Dopo aver ricevuto una notifica, un client può determinare se è l'origine dell'evento o un altro client controllando il valore EventContext . Questo schema dipende dal client che seleziona un valore per questo parametro univoco tra tutti i client nella sessione. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto 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 |
|---|---|
|
Il raggruppamento dei parametri è 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
Un client chiama questo metodo per modificare il parametro di raggruppamento di una sessione. 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.
Il client può ottenere il parametro di raggruppamento corrente per la sessione chiamando il metodo IAudioSessionControl::GetGroupingParam .
Se un client non ha mai chiamato SetGroupingParam per assegnare un parametro di raggruppamento a una sessione, la sessione non appartiene ad alcun raggruppamento. Una sessione che non appartiene ad alcun raggruppamento ha un dispositivo di scorrimento a livello di volume dedicato nel programma Sndvol.
Requisiti
| 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