Metodo IAudioSessionEvents::OnDisplayNameChanged (audiopolicy.h)

Il metodo OnDisplayNameChanged notifica al client che il nome visualizzato per la sessione è stato modificato.

Sintassi

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

Parametri

[in] NewDisplayName

Nuovo nome visualizzato per la sessione. Questo parametro punta a una stringa di caratteri wide con terminazione Null contenente il nuovo nome visualizzato. La stringa rimane valida per la durata della chiamata.

[in] EventContext

Valore del contesto dell'evento. Si tratta dello stesso valore passato al chiamante IAudioSessionControl::SetDisplayName nella chiamata che ha modificato il nome visualizzato 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::SetDisplayName modifica il nome visualizzato della sessione. Il programma Sndvol usa il nome visualizzato di una sessione per etichettare il dispositivo di scorrimento del volume per la sessione.

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

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

Requisiti

Requisito	Valore
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

IAudioSessionControl::SetDisplayName

Interfaccia IAudioSessionEvents