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

El método OnIconPathChanged notifica al cliente que ha cambiado el icono de presentación de la sesión.

Sintaxis

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

Parámetros

[in] NewIconPath

Ruta de acceso del nuevo icono de presentación de la sesión. Este parámetro apunta a una cadena que contiene la ruta de acceso del nuevo icono. El puntero de cadena permanece válido solo durante la llamada.

[in] EventContext

Valor del contexto del evento. Este es el mismo valor que el autor de la llamada pasó a IAudioSessionControl::SetIconPath en la llamada que cambió el icono de presentación 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::SetIconPath cambia el icono de presentación de la sesión. El programa Sndvol usa el icono de visualización 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 icono de visualización que inició y otro iniciado por el cliente. Al llamar al método IAudioSessionControl::SetIconPath , un cliente pasa un valor de parámetro EventContext que su implementación del método OnIconPathChanged puede reconocer.

Para obtener un ejemplo de código que implemente los métodos en la interfaz IAudioSessionEvents , consulte 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::SetIconPath

Interfaz IAudioSessionEvents