Compartir a través de


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

El método OnGroupingParamChanged notifica al cliente que el parámetro de agrupación de la sesión ha cambiado.

Sintaxis

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

Parámetros

[in] NewGroupingParam

Nuevo parámetro de agrupación para la sesión. Este parámetro apunta a un GUID de parámetro de agrupación.

[in] EventContext

Valor de contexto del evento. Este es el mismo valor que el autor de la llamada pasó a IAudioSessionControl::SetGroupingParam en la llamada que cambió el parámetro de agrupació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::SetGroupingParam cambia el parámetro de agrupación de la sesión.

El parámetro EventContext proporciona un medio para que un cliente distinga entre un cambio de parámetro de agrupación que inició y otro iniciado por el cliente. Al llamar al método IAudioSessionControl::SetGroupingParam , un cliente pasa un valor de parámetro EventContext que su implementación del método OnGroupingParamChanged 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::SetGroupingParam

IAudioSessionEvents (Interfaz)