Método IAudioSessionControl::SetGroupingParam (audiopolicy.h)

  • Artículo

El método SetGroupingParam asigna una sesión a una agrupación de sesiones.

Sintaxis

HRESULT SetGroupingParam(
  [in] LPCGUID Override,
  [in] LPCGUID EventContext
);

Parámetros

[in] Override

Nuevo parámetro de agrupación. Este parámetro debe ser un puntero válido que no sea NULL a un GUID de parámetro de agrupación. Para obtener más información, vea la sección Comentarios.

[in] EventContext

Puntero al GUID de contexto de evento. Si una llamada a este método genera un evento de cambio de agrupación, el administrador de sesiones envía notificaciones a todos los clientes que han registrado interfaces IAudioSessionEvents con el administrador de sesiones. El administrador de sesiones incluye el valor del puntero EventContext con cada notificación. Tras recibir una notificación, un cliente puede determinar si es o no el origen del evento inspeccionando el valor eventContext . Este esquema depende del cliente que seleccione un valor para este parámetro que sea único entre todos los clientes de la sesión. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto NULL .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 La agrupación de parámetros es NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o dejado de estar disponible para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
 El servicio de audio de Windows no se está ejecutando.

Comentarios

Un cliente llama a este método para cambiar el parámetro de agrupación de una sesión. Todas las sesiones de audio que tienen el mismo valor de parámetro de agrupación están bajo el control del mismo control deslizante de nivel de volumen en el programa de control de volumen del sistema, Sndvol. Para obtener más información, vea Agrupar parámetros.

El cliente puede obtener el parámetro de agrupación actual para la sesión llamando al método IAudioSessionControl::GetGroupingParam .

Si un cliente nunca ha llamado a SetGroupingParam para asignar un parámetro de agrupación a una sesión, la sesión no pertenece a ninguna agrupación. Una sesión que no pertenece a ninguna agrupación tiene su propio control deslizante de nivel de volumen dedicado en el programa Sndvol.

Requisitos

   
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 (Interfaz)

IAudioSessionControl::GetGroupingParam

IAudioSessionEvents (Interfaz)