Metodo IAudioSessionControl::SetGroupingParam (audiopolicy.h)

Articolo
08/22/2023

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
E_POINTER	Il raggruppamento dei parametri è 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

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

IAudioSessionControl::GetGroupingParam

Interfaccia IAudioSessionEvents

Condividi tramite