Método IAudioSessionEvents::OnDisplayNameChanged (audiopolicy.h)

El método OnDisplayNameChanged notifica al cliente que ha cambiado el nombre para mostrar de la sesión.

Sintaxis

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

Parámetros

[in] NewDisplayName

Nuevo nombre para mostrar de la sesión. Este parámetro apunta a una cadena de caracteres anchos terminada en NULL que contiene el nuevo nombre para mostrar. La cadena sigue siendo válida durante la llamada.

[in] EventContext

Valor de contexto del evento. Este es el mismo valor que el autor de la llamada pasó a IAudioSessionControl::SetDisplayName en la llamada que cambió el nombre para mostrar de la sesión. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Comentarios

El administrador de sesiones llama a este método cada vez que una llamada al método IAudioSessionControl::SetDisplayName cambia el nombre para mostrar de la sesión. El programa Sndvol usa el nombre para mostrar de una sesión para etiquetar el control deslizante del volumen de la sesión.

El parámetro EventContext proporciona un medio para que un cliente distinga entre un cambio de nombre para mostrar que inició y otro iniciado por el cliente. Al llamar al método IAudioSessionControl::SetDisplayName , un cliente pasa un valor de parámetro EventContext que su implementación del método OnDisplayNameChanged puede reconocer.

Para obtener un ejemplo de código que implementa los métodos en la interfaz IAudioSessionEvents , vea Eventos de sesión de audio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	audiopolicy.h

Consulte también

IAudioSessionControl::SetDisplayName

IAudioSessionEvents (Interfaz)