Metodo IAudioSessionEvents::OnIconPathChanged (audiopolicy.h)

Il metodo OnIconPathChanged notifica al client che l'icona di visualizzazione per la sessione è stata modificata.

Sintassi

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

Parametri

[in] NewIconPath

Percorso della nuova icona di visualizzazione per la sessione. Questo parametro punta a una stringa contenente il percorso per la nuova icona. Il puntatore stringa rimane valido solo per la durata della chiamata.

[in] EventContext

Valore del contesto dell'evento. Si tratta dello stesso valore passato al chiamante IAudioSessionControl::SetIconPath nella chiamata che ha modificato l'icona di visualizzazione 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

La gestione sessione chiama questo metodo ogni volta che una chiamata al metodo IAudioSessionControl::SetIconPath modifica l'icona di visualizzazione per la sessione. Il programma Sndvol usa l'icona di visualizzazione di una sessione per etichettare il dispositivo di scorrimento del volume per la sessione.

Il parametro EventContext fornisce un mezzo per un client per distinguere tra una modifica dell'icona di visualizzazione avviata e quella avviata da un altro client. Quando si chiama il metodo IAudioSessionControl::SetIconPath , un client passa un valore di parametro EventContext che la relativa implementazione del metodo OnIconPathChanged può riconoscere.

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

Requisiti

Vedi anche

IAudioSessionControl::SetIconPath

Interfaccia IAudioSessionEvents