Metodo IAudioSessionEvents::OnSimpleVolumeChanged (audiopolicy.h)

Il metodo OnSimpleVolumeChanged notifica al client che il livello del volume o lo stato di disattivazione della sessione audio è cambiato.

Sintassi

HRESULT OnSimpleVolumeChanged(
  [in] float   NewVolume,
  [in] BOOL    NewMute,
  [in] LPCGUID EventContext
);

Parametri

[in] NewVolume

Nuovo livello di volume per la sessione audio. Questo parametro è un valore compreso nell'intervallo da 0,0 a 1,0, dove 0,0 è in silenzio e 1,0 è pieno volume (nessuna attenuazione).

[in] NewMute

Nuovo stato di disattivazione. Se TRUE, la disattivazione è abilitata. Se FALSE, l'opzione di disattivazione è disabilitata.

[in] EventContext

Valore del contesto dell'evento. Si tratta dello stesso valore passato al chiamante ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute nella chiamata che ha modificato il livello del volume o lo stato di disattivazione della 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 ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute modifica il livello del volume o lo stato di disattivazione della sessione.

Il parametro EventContext consente a un client di distinguere tra un volume o una modifica disattivata avviata e quella avviata da un altro client. Quando si chiama il metodo ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute , un client passa un valore di parametro EventContext che l'implementazione del metodo OnSimpleVolumeChanged può riconoscere.

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

Requisiti

Vedi anche

Interfaccia IAudioSessionEvents

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute