Metodo IAudioSessionEvents::OnGroupingParamChanged (audiopolicy.h)

Il metodo OnGroupingParamChanged notifica al client che il parametro di raggruppamento per la sessione è stato modificato.

Sintassi

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

Parametri

[in] NewGroupingParam

Nuovo parametro di raggruppamento per la sessione. Questo parametro punta a un GUID del parametro di raggruppamento.

[in] EventContext

Valore del contesto dell'evento. Si tratta dello stesso valore passato al chiamante IAudioSessionControl::SetGroupingParam nella chiamata che ha modificato il parametro di raggruppamento per la sessione. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Il gestore di sessioni chiama questo metodo ogni volta che una chiamata al metodo IAudioSessionControl::SetGroupingParam modifica il parametro di raggruppamento per la sessione.

Il parametro EventContext consente a un client di distinguere tra una modifica di parametri di raggruppamento avviata e quella avviata da un altro client. Quando si chiama il metodo IAudioSessionControl::SetGroupingParam , un client passa un valore di parametro EventContext che l'implementazione del metodo OnGroupingParamChanged può riconoscere.

Per un esempio di codice che implementa i metodi nell'interfaccia IAudioSessionEvents , vedi Eventi sessione audio.

Requisiti

Vedi anche

IAudioSessionControl::SetGroupingParam

Interfaccia IAudioSessionEvents